升级Quarkus 3.2.x后hibernate-jpamodelgen无法生成元模型类

• 严格对齐Hibernate ORM版本
  Quarkus 3.x基于Hibernate ORM 6.x，hibernate-jpamodelgen的版本必须与Quarkus内置的Hibernate版本完全一致。Quarkus 3.2.2/3.2.3对应的Hibernate ORM版本是6.2.7.Final，不要随意指定其他版本。可以直接通过Quarkus的BOM来管理依赖，避免版本冲突：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>io.quarkus</groupId>
              <artifactId>quarkus-bom</artifactId>
              <version>3.2.3.Final</version>
              <type>pom</type>
              <scope>import</scope>
          </dependency>
      </dependencies>
  </dependencyManagement>
  

  此时hibernate-jpamodelgen无需指定版本，会自动匹配BOM中的对应版本。

• 显式配置注解处理器路径
  在Quarkus 3.x中，仅依赖provided scope的hibernate-jpamodelgen可能无法被编译器自动识别为注解处理器。需要在Maven的编译插件中显式配置注解处理器路径：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <configuration>
                  <annotationProcessorPaths>
                      <path>
                          <groupId>org.hibernate.orm</groupId>
                          <artifactId>hibernate-jpamodelgen</artifactId>
                          <scope>provided</scope>
                      </path>
                  </annotationProcessorPaths>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

• 检查实体类注解兼容性
  Hibernate 6.x对JPA注解的处理有变更，比如移除了部分过时注解、调整了注解的生效逻辑。检查你的JPA实体类：

  • 避免使用Hibernate 6.x已废弃的注解（如@Type的部分用法）
  • 确保@Entity、@Id等核心注解的使用符合JPA 3.0规范（Quarkus 3.x基于JPA 3.0）

• 清理构建缓存并重新编译
  执行mvn clean install彻底清理之前的构建产物，包括生成的元模型类。编译完成后检查target/generated-sources/annotations目录，确认是否有生成的元模型类文件。

• 确认Quarkus插件与扩展版本匹配
  确保quarkus-maven-plugin的版本与项目Quarkus版本一致，同时确认quarkus-hibernate-orm扩展已正确引入且版本匹配：

  <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-hibernate-orm</artifactId>
  </dependency>
  

内容的提问来源于stack exchange，提问作者Gonçalo C