Gradle项目中集成JPA元模型生成器：常见问题与版本管理策略

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

sourceCompatibility = '17'
// 定义元模型生成目录，通常放在 build/generated/sources/java
def generatedSourcesDir = "${buildDir}/generated/sources/java"

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

    // 对于Java 9+，可能需要此依赖以支持JAXB
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'

    // JPA元模型生成器作为注解处理器
    // 注意：此处不指定版本，详见下文解释
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen'
    compileOnly 'org.projectlombok:lombok:1.18.24' // 常用工具，非必须
    runtimeOnly 'com.sun.xml.bind:jaxb-impl:3.0.1' // JAXB实现，非必须
}

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

compileJava {
    // 确保生成目录存在
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    // 配置编译器参数，指定生成目录和附加选项
    options.compilerArgs += ['-s', generatedSourcesDir] // 指定生成目录
    options.compilerArgs += ['-AaddGenerationDate=true'] // 示例：添加生成日期
    // options.compilerArgs += '-proc:none' // 不处理注解，通常不用于主编译任务
    println "Args for $name are $options.allCompilerArgs"
}

// 可选：如果测试也需要元模型，可类似配置
compileTestJava {
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    options.compilerArgs += ['-s', generatedSourcesDir]
    options.compilerArgs += ['-AaddGenerationDate=true']
    // 注意：测试编译时可能需要禁用注解处理，如果元模型已在主编译时生成
    // options.compilerArgs += '-proc:none'
}

dependencies {
    // ... 其他依赖

    // 移除显式版本声明，让Spring Boot的依赖管理插件自动选择兼容版本
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen'

    // ... 其他依赖
}

plugins {
    id 'org.springframework.boot' version '2.7.5' // 使用您的Spring Boot版本
    id 'io.spring.dependency-management' version '1.0.15.RELEASE' // 使用您的依赖管理插件版本
    id 'java'
}

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'

    // Java 9+ JAXB API支持
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'

    // JPA元模型生成器，不指定版本，由Spring Boot依赖管理处理
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen'

    // 其他常用依赖
    compileOnly 'org.projectlombok:lombok:1.18.24'
    runtimeOnly 'com.sun.xml.bind:jaxb-impl:3.0.1' // JAXB实现
    runtimeOnly 'com.h2database:h2' // 示例数据库
}

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

compileJava {
    // 确保生成目录存在
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    // 配置编译器参数
    options.compilerArgs += ['-s', generatedSourcesDir] // 指定元模型生成目录
    options.compilerArgs += ['-AaddGenerationDate=true'] // 示例：添加生成日期
    // 调试输出编译器参数
    println "Args for $name are $options.allCompilerArgs"
}

// 对于测试，通常不需要再次生成元模型，因为主编译阶段已经生成
// 如果测试需要独立生成或处理注解，请谨慎配置，避免重复或冲突
// compileTestJava {
//     doFirst {
//         file(generatedSourcesDir).mkdirs()
//     }
//     options.compilerArgs += ['-s', generatedSourcesDir]
//     options.compilerArgs += ['-AaddGenerationDate=true']
//     options.compilerArgs += '-proc:none' // 通常在测试编译时禁用注解处理，如果元模型已在主编译时生成
// }

test {
    useJUnitPlatform()
}