jpamodelgen结合MapStruct与Lombok时元模型静默不生成问题排查

可能的原因 #

• 实体类注解或访问权限问题：检查目标实体类dCF是否标注了@Entity等JPA核心注解，同时确保实体类是public访问修饰符——包私有或private类会导致jpamodelgen无法扫描生成元模型。
• 注解处理器顺序冲突：同时使用Lombok、MapStruct、jpamodelgen时，处理器执行顺序会影响结果。Lombok需要优先处理，否则jpamodelgen无法识别Lombok生成的字段，建议在maven-compiler-plugin的annotationProcessorPaths里把Lombok放在最前面，再依次是jpamodelgen、MapStruct。
• 依赖范围或版本不兼容：hibernate-jpamodelgen的依赖范围必须设为provided或compileOnly，设为runtime会导致编译时不生效；同时要确保jpamodelgen版本与Hibernate Reactive版本匹配（比如Reactive 2.x对应jpamodelgen 6.x，Reactive 1.x对应jpamodelgen 5.x）。
• maven-compiler-plugin配置疏漏：确认插件版本支持Java 11（建议3.8.1及以上），且annotationProcessorPaths里正确引入了jpamodelgen依赖，没有遗漏路径配置。
• 编译目录权限问题：元模型类默认生成在target/generated-sources/annotations目录，若该目录无写入权限，会导致生成失败但无报错提示，检查目录是否存在且有读写权限。

开启jpamodelgen额外日志的方法 #

方法1：通过Maven命令参数开启 #

执行编译时添加调试参数和jpamodelgen日志参数，命令如下：

mvn clean compile -X -Ahibernate.jpamodelgen.logging=DEBUG

-X会开启Maven整体调试日志，-Ahibernate.jpamodelgen.logging=DEBUG会让jpamodelgen输出详细扫描、生成日志。

方法2：在pom.xml中配置编译参数 #

直接在maven-compiler-plugin里添加日志参数，示例配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.8.1</version>
  <configuration>
    <source>11</source>
    <target>11</target>
    <annotationProcessorPaths>
      <path>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>${lombok.version}</version>
      </path>
      <path>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-jpamodelgen</artifactId>
        <version>${hibernate.version}</version>
      </path>
      <path>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>${mapstruct.version}</version>
      </path>
    </annotationProcessorPaths>
    <compilerArgs>
      <arg>-Ahibernate.jpamodelgen.logging=DEBUG</arg>
    </compilerArgs>
  </configuration>
</plugin>

配置完成后执行mvn clean compile，就能在控制台看到jpamodelgen的详细运行日志，包括扫描到的实体类、生成步骤等信息。

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