升级至Jakarta/Java17后APT生成器失效问题排查求助

• 检查Hibernate Core自带的APT处理器冲突
  Hibernate 6.x的hibernate-core本身内置了JPA元模型生成的处理器实现，很可能和你单独引入的jpamodelgen包存在优先级冲突或类加载问题。可以做这两步验证：

  • 解压hibernate-core-6.1.6.Final.jar，查看是否包含jakarta.persistence.annotation.processing路径下的处理器类；
  • 执行javac -processorpath <你的processorpath路径> -listProcessors命令，查看实际被javac加载的处理器列表，确认是否有多个JPA元模型处理器共存，导致jpamodelgen被覆盖或跳过。

• 对齐jpamodelgen与Hibernate Core的版本
  你当前使用的jpamodelgen版本是否和Hibernate Core 6.1.6匹配？Hibernate 6.x对应的元模型生成器也需是6.x版本，版本不匹配会导致处理器初始化失败。尝试将jpamodelgen的版本同步到6.1.6后重新编译测试。

• 校验实体类的Jakarta注解迁移完整性
  从javax升级到Jakarta后，要确保实体类（包括父类MappedEntity）完全替换了注解包：不能混用javax.persistence.*和jakarta.persistence.*。Hibernate 6.x只识别Jakarta注解，若存在残留的javax注解，处理器会无法识别实体，自然不会生成元模型。

• 开启APT的详细调试日志
  给javac添加以下参数，捕捉APT处理的完整过程：

  • -XprintRounds：打印注解处理的轮次信息，确认处理器是否被触发；
  • -XprintProcessorInfo：打印处理器处理的元素信息，查看是否跳过了你的实体类；
  • -Adebug=true：如果jpamodelgen支持该参数，会输出更详细的调试日志，帮助定位初始化或处理失败的原因；
  • -verbose：查看类加载细节，确认jpamodelgen的类是否被正确加载，是否存在类加载异常。

• 排查Gradle多模块的隐性依赖
  多模块项目容易出现依赖传递导致的冲突：

  • 执行gradle dependencies --configuration annotationProcessor，查看注解处理器路径的完整依赖树，确认是否有其他模块传递过来的意外处理器或冲突依赖；
  • 临时将实体模块改为独立模块，排除所有其他模块的依赖，只保留jakarta.persistence-api、jpamodelgen和hibernate-core，再测试编译，验证是否是跨模块依赖导致的问题。

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