Quarkus项目中hibernate-jpamodelgen无法生成元模型类求助

问题分析 #

在Quarkus项目中添加hibernate-jpamodelgen依赖后，无法生成MyEntity_这类Criteria查询所需的元模型类，即使添加JAXB依赖也无效，且编译日志无错误提示。核心原因是Quarkus对注解处理器的依赖配置逻辑与Spring Boot不同，硬指定版本或未正确配置依赖范围会导致处理器未生效。

解决方案 #

1. 修正依赖配置 #

移除手动指定的版本号，借助Quarkus BOM统一管理依赖版本，并将hibernate-jpamodelgen的依赖范围设为provided（仅编译阶段需要）：

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-jpamodelgen</artifactId>
    <scope>provided</scope>
</dependency>

说明：Quarkus通过内置BOM统一管控所有框架依赖版本，手动指定版本极易与内置Hibernate ORM版本冲突，导致注解处理器无法正常工作。

2. 显式配置注解处理器路径 #

若上述配置后仍未生成元模型，需在maven-compiler-plugin中明确指定注解处理器路径：

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

3. 检查IntelliJ IDE配置 #

• 打开Settings > Build, Execution, Deployment > Compiler > Annotation Processors
• 勾选Enable annotation processing
• 选择Obtain processors from project classpath（确保使用Maven管理的注解处理器，而非IntelliJ内置处理器）
• 执行Maven编译命令：mvn clean compile，查看target/generated-sources/annotations目录是否生成元模型类

4. 移除冗余JAXB依赖 #

Quarkus 2.x及以上版本的Hibernate ORM依赖已内置JAXB相关组件，无需额外添加jaxb-api或jaxb-runtime，多余依赖反而可能引发冲突。

验证 #

执行mvn clean compile后，target/generated-sources/annotations目录下应生成MyEntity_类，示例代码如下：

@Generated(value = "org.hibernate.jpamodelgen.JPAMetaModelEntityProcessor")
@StaticMetamodel(MyEntity.class)
public abstract class MyEntity_ {
    public static volatile SingularAttribute<MyEntity, Long> id;
    public static volatile SingularAttribute<MyEntity, String> field;
}

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