Spring Gradle项目中Lombok与JPA Metamodel兼容问题及解决方案

问题根源 #

JPA Metamodel生成器默认依赖实体类的getter方法（或public字段）识别属性，但Lombok的注解（如@Data）是在编译时动态生成getter/setter的。如果Metamodel生成器的注解处理器在Lombok之前执行，它会看不到Lombok生成的访问方法，从而导致生成的*_类无法正确映射实体属性，最终出现识别失败的问题。

具体解决步骤 #

1. 调整注解处理器执行顺序（Gradle） #

确保Lombok的注解处理器优先于JPA Metamodel生成器执行，这样Metamodel生成时能看到Lombok已经生成的getter/setter。修改你的Gradle依赖配置：

dependencies {
    // Lombok依赖
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'

    // JPA Metamodel生成依赖（根据你的Hibernate/JPA版本调整）
    annotationProcessor 'org.hibernate:hibernate-jpamodelgen:6.4.4.Final'
    implementation 'org.hibernate.javax.persistence:hibernate-jpa-2.1-api:1.0.2.Final'
}

2. 让JPA直接访问字段（替代依赖getter） #

在实体类上添加@Access(AccessType.FIELD)注解，告诉JPA Metamodel生成器直接使用实体类的字段，而不是依赖getter方法。结合Lombok注解使用示例：

@Entity
@Data
@Access(AccessType.FIELD) // 关键注解，指定字段访问模式
public class YourEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    // 其他字段...
}

3. 确保IDE识别生成的Metamodel类 #

在Gradle中配置源码集，让IDE将生成目录标记为“Generated Sources Root”：

sourceSets {
    main {
        java {
            srcDirs += 'build/generated/sources/annotationProcessor/java/main'
        }
    }
}

如果是IntelliJ IDEA，也可以手动右键点击build/generated目录 → Mark Directory as → Generated Sources Root。

4. 清理缓存并重新构建 #

执行Gradle清理命令，清除旧的生成文件和编译缓存：

./gradlew clean build

如果IDE仍有报错，尝试File → Invalidate Caches... → Invalidate and Restart。

关于Lombok与JPA Criteria/Metamodel的“并发问题” #

两者本身不存在真正的并发问题，核心冲突是注解处理器的执行顺序。只要确保Lombok先于Metamodel生成器处理实体类，就能完美兼容。JPA Criteria API使用Metamodel类时，只需要生成的*_类正确映射实体属性即可，和Lombok的运行时增强没有冲突。

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