Gradle项目集成JPA元模型生成器指南与常见版本冲突解决

plugins {
    id 'org.springframework.boot' version '2.7.5'
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    id 'java'
}

// ... 其他配置

dependencies {
    // 核心JPA和Web依赖
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-web'

    // JPA元模型生成器作为注解处理器
    // 注意：此处不指定版本号，详见下文“常见陷阱”部分
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen'

    // 如果项目使用Lombok，也需要将其声明为compileOnly或annotationProcessor
    compileOnly 'org.projectlombok:lombok:1.18.24'

    // JAXB API 和实现，在某些Java版本中可能需要
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'
    runtimeOnly 'com.sun.xml.bind:jaxb-impl:3.0.1'
}

// ... 其他配置

sourceCompatibility = '17'
def generatedSourcesDir = "${buildDir}/generated/sources/java" // 定义生成目录

sourceSets.main.java.srcDirs += (generatedSourcesDir) // 将生成目录添加到主源代码集

// ... 其他配置

compileJava {
    // 在编译前确保生成目录存在
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    // 配置注解处理器输出目录
    options.compilerArgs += ['-s', generatedSourcesDir]
    // 可选：添加生成日期到元模型文件
    options.compilerArgs += ['-AaddGenerationDate=true']
    // 确保注解处理器被执行，不要添加 '-proc:none'
}

dependencies {
    // ... 其他依赖

    // 移除版本号，让Spring Boot的依赖管理机制自动选择兼容版本
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen'

    // ... 其他依赖
}

plugins {
    id 'org.springframework.boot' version '2.7.5'
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

// 定义元模型生成目录
def generatedSourcesDir = "${buildDir}/generated/sources/java"

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-web'

    // JAXB API 和实现，在某些Java版本中可能需要
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'
    runtimeOnly 'com.sun.xml.bind:jaxb-impl:3.0.1'

    // JPA元模型生成器，不指定版本号
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen'

    // Lombok (如果使用)
    compileOnly 'org.projectlombok:lombok:1.18.24'
    annotationProcessor 'org.projectlombok:lombok:1.18.24' // Lombok也需要作为注解处理器
}

// 将生成目录添加到主源代码集
sourceSets.main.java.srcDirs += (generatedSourcesDir)

compileJava {
    // 确保生成目录存在
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    // 配置注解处理器输出目录
    options.compilerArgs += ['-s', generatedSourcesDir]
    // 可选：添加生成日期
    options.compilerArgs += ['-AaddGenerationDate=true']
    // 注意：此处不应添加 '-proc:none'
    println "Args for $name are $options.allCompilerArgs"
}

// 示例：测试编译任务可以禁用注解处理器以加快速度
compileTestJava {
    doFirst {
        file(generatedSourcesDir).mkdirs() // 即使禁用，目录也应存在
    }
    options.compilerArgs += ['-s', generatedSourcesDir]
    options.compilerArgs += '-proc:none' // 禁用测试编译的注解处理器
}

// ... 其他可能的Gradle任务配置