使用Maven构建时hibernate-jpamodelgen未生成JPA元模型问题

1. 调整注解处理器的依赖顺序与配置方式 #

多个注解处理器共存时，Maven的执行顺序可能影响生成结果，尤其是Lombok与hibernate-jpamodelgen搭配使用的场景。要确保hibernate-jpamodelgen被正确加载，同时让Maven识别生成的元模型目录。

修改maven-compiler-plugin配置，显式指定所有处理器，并将生成目录加入编译路径：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 选用适配Java 11的稳定版本 -->
            <configuration>
                <source>11</source>
                <target>11</target>
                <annotationProcessorPaths>
                    <!-- 按Lombok → JPAModelGen → MapStruct的顺序配置 -->
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>${lombok.version}</version>
                    </path>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok-mapstruct-binding</artifactId>
                        <version>${lombok-mapstruct-binding.version}</version>
                    </path>
                    <path>
                        <groupId>org.hibernate</groupId>
                        <artifactId>hibernate-jpamodelgen</artifactId>
                        <version>5.4.29.Final</version>
                    </path>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${mapstruct.version}</version>
                    </path>
                </annotationProcessorPaths>
                <!-- 指定生成目录，确保被Maven识别为源码目录 -->
                <generatedSourcesDirectory>${project.build.directory}/generated-sources/annotations</generatedSourcesDirectory>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 检查实体类注解的正确性 #

确保实体类符合JPA要求：

• 必须标注@Entity注解（Spring Boot 5.x用javax.persistence.Entity，6.x用jakarta.persistence.Entity）
• 实体类为public访问权限，无语法错误
• 所在包被Spring Boot的组件扫描覆盖

3. 清理Maven缓存后重新构建 #

缓存可能导致处理器执行异常，执行以下命令彻底清理后重新构建：

mvn clean install -U

-U参数强制更新依赖快照，避免旧缓存干扰。

4. 排查插件冲突 #

如果项目使用spring-boot-maven-plugin的repackage目标，确保它在编译阶段之后执行。同时检查是否有其他代码生成插件（如maven-processor-plugin）与maven-compiler-plugin冲突，建议仅保留maven-compiler-plugin处理注解处理器。

5. 查看处理器执行日志 #

通过调试日志确认hibernate-jpamodelgen是否被调用：

mvn clean package -X

在日志中搜索JPAModelEntityProcessor或hibernate-jpamodelgen，如果没有相关记录，说明处理器未被加载，检查依赖scope是否正确（需配置在annotationProcessorPaths中，或设为provided，不要用compile）。

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