如何在Gradle与IntelliJ IDEA中配置使用JPA Metamodel？

嘿，我完全懂这种“以为很简单结果卡半天”的感觉！Spring Boot 默认确实不会自动生成 JPA Metamodel，得给 Gradle 和 IDEA 做些配置才行，我给你一步步捋清楚：

首先要引入Hibernate的元模型生成器依赖，而且必须用annotationProcessor配置，不能用implementation——因为它只在编译阶段起作用，不需要打包到最终程序里。

Groovy DSL版本： #

dependencies {
    // 你的其他依赖，比如spring-boot-starter-data-jpa
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    
    // 注意版本要和Spring Boot 2.0.0配套的Hibernate版本一致（2.0.0用的是Hibernate 5.2.17.Final）
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen:5.2.17.Final'
}

// 配置生成的元模型类存放的目录，并让编译任务依赖资源处理任务
sourceSets {
    generated {
        java {
            srcDirs = ['build/generated/sources/annotationProcessor/java/main']
        }
    }
}

compileJava.dependsOn(processResources)

如果用Kotlin DSL（build.gradle.kts）： #

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-data-jpa")
    annotationProcessor("org.hibernate:hibernate-jpamodelgen:5.2.17.Final")
}

sourceSets {
    create("generated") {
        java.srcDir("build/generated/sources/annotationProcessor/java/main")
    }
}

tasks.compileJava {
    dependsOn(tasks.processResources)
}

Gradle编译后会把元模型类放到build/generated/sources/annotationProcessor/java/main目录，但IDEA默认不会把这个目录标记为“源码根目录”，所以会出现找不到类的情况：

• 右键点击这个目录，选择Mark Directory as -> Sources Root
• 这样IDEA就会把这些生成的类当成普通源码处理，不会报红了

确保你的实体类符合JPA规范：

• 必须标注@Entity注解
• 元模型类会以实体类名_的形式生成（比如实体是Book，生成的元模型就是Book_）
• 实体里的字段如果用了@Column、@Id等注解，元模型里会生成对应的静态属性，方便你在Criteria查询中使用

• 直接在IDEA的Gradle面板里运行compileJava任务，或者在终端执行./gradlew compileJava
• 编译完成后去build/generated/...目录下找，就能看到生成的元模型类了

如果还是没生成，检查这几点：

• 版本是否匹配：Spring Boot 2.0.0对应的Hibernate版本是5.2.17.Final，jpamodelgen版本必须和它一致
• 是不是把annotationProcessor写成了implementation？这个很容易错
• IDEA缓存问题：试试File -> Invalidate Caches / Restart，清理后重新编译

内容的提问来源于stack exchange，提问作者jjangga