Quarkus应用编译时MapStruct代码生成随机失效问题求助

问题核心 #

编译时随机出现FlightMapperImpl未生成toDTO/toDAO方法的完整属性赋值逻辑，伴随警告：

[WARNING] Implicitly compiled files were not subject to annotation processing.
Use -proc:none to disable annotation processing or -implicit to specify a policy for implicit compilation.

本质是Maven增量编译过程中，隐式编译的文件未触发注解处理器执行，导致MapStruct无法基于Lombok生成的getter/setter完成映射代码生成。

解决方案 #

1. 强制隐式编译类参与注解处理 #

在maven-compiler-plugin的compilerArgs中添加-implicit:class参数，确保所有编译类都走注解处理器流程：

<compilerArgs>
  <arg>-parameters</arg>
  <arg>-implicit:class</arg>
</compilerArgs>

2. 引入Lombok-MapStruct绑定依赖 #

添加专门协调两者执行顺序的依赖，保证Lombok先生成属性访问器，再由MapStruct生成映射代码：

<!-- 在dependencies节点添加 -->
<dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok-mapstruct-binding</artifactId>
  <version>${org.projectlombok.version}</version>
  <scope>provided</scope>
</dependency>

同时在注解处理器路径中加入该依赖：

<annotationProcessorPaths>
  <!-- 保留原有处理器路径 -->
  <path>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok-mapstruct-binding</artifactId>
    <version>${org.projectlombok.version}</version>
  </path>
</annotationProcessorPaths>

3. 禁用增量编译（可选） #

若上述配置仍有随机问题，可强制全量编译避免缓存干扰：

• 构建时执行：quarkus build --no-incremental
• 或在application.properties中添加：quarkus.compiler.incremental=false

4. 清理构建缓存 #

出现异常时，先清理缓存再重新构建：

mvn clean quarkus build

验证 #

修改配置后，多次执行构建或启动dev模式，检查target/generated-sources/annotations下的FlightMapperImpl.java，确认toDTO/toDAO方法中包含完整的属性赋值代码。

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