Gradle项目中集成JPA元模型生成器：配置与常见问题解决

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

// ... 其他配置

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

    // JPA元模型生成器依赖，注意其作用域为 annotationProcessor
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen' // 不指定版本，让Spring Boot管理

    // Lombok等其他注解处理器也在此处配置
    compileOnly 'org.projectlombok:lombok:1.18.24'
    annotationProcessor 'org.projectlombok:lombok:1.18.24' // 如果使用Lombok，其注解处理器也需配置

    // 其他运行时依赖
    runtimeOnly 'com.sun.xml.bind:jaxb-impl' // Spring Boot 2.x/Jakarta EE 9+ 可能需要
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api'
}

// ... plugins 和 dependencies 配置之后

sourceCompatibility = '17' // 或您项目使用的Java版本
def generatedSourcesDir = "${buildDir}/generated/sources/java" // 定义生成目录

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

// ... sourceSets 配置之后

compileJava {
    doFirst {
        // 在编译前确保生成目录存在
        file(generatedSourcesDir).mkdirs()
    }
    options.compilerArgs += ['-AaddGenerationDate=true'] // 可选：添加生成日期到元模型类
    options.compilerArgs += ['-s', generatedSourcesDir] // 指定元模型输出目录
    // options.compilerArgs += '-proc:none' // 注意：此处不应启用，否则会禁用注解处理
    println "Args for $name are $options.allCompilerArgs" // 打印编译器参数，便于调试
}

compileTestJava {
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    options.compilerArgs += ['-AaddGenerationDate=true']
    options.compilerArgs += ['-s', generatedSourcesDir]
    // 对于测试编译，通常不希望再次生成，或者如果主编译已经生成，则可以禁用注解处理
    // 如果测试代码依赖主模块生成的元模型，则此行是多余的，甚至可能导致问题。
    // 如果测试需要独立生成元模型，则保留。
    // 通常情况下，如果主编译已经生成，测试编译不需要再次生成，可以考虑移除这部分配置或使用 '-proc:none'
    // options.compilerArgs += '-proc:none' // 如果主编译已生成，测试编译可禁用注解处理
}

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'

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

    // Lombok相关依赖
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'

    // JAXB API 和实现，Spring Boot 2.x 或 Jakarta EE 9+ 可能需要
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api'
    runtimeOnly 'com.sun.xml.bind:jaxb-impl'

    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

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

compileJava {
    doFirst {
        // 确保生成目录存在
        file(generatedSourcesDir).mkdirs()
    }
    // 配置注解处理器参数
    options.compilerArgs += ['-AaddGenerationDate=true']
    options.compilerArgs += ['-s', generatedSourcesDir] // 指定输出目录
    println "Args for $name are $options.allCompilerArgs"
}

// 如果测试代码也需要访问或生成元模型，可以类似配置
// 通常情况下，如果主编译已经生成，测试编译不需要重复生成
compileTestJava {
    // 确保生成目录存在（如果测试也需要独立生成）
    doFirst {
        file(generatedSourcesDir).mkdirs()
    }
    // 配置注解处理器参数
    options.compilerArgs += ['-AaddGenerationDate=true']
    options.compilerArgs += ['-s', generatedSourcesDir]
    // 如果不希望测试编译重复生成元模型，可以添加 -proc:none
    // options.compilerArgs += '-proc:none'
}

tasks.named('test') {
    useJUnitPlatform()
}