整合Lombok与MapStruct时Tomcat部署出现Autowired注入失败

1. Maven 编译插件配置失效 #

• 当前maven-compiler-plugin的所有配置仅写在 节点下，该节点仅作为插件配置的统一模板，不会在构建流程中实际触发插件执行。
• Eclipse STS 本地运行时，IDE内置了Lombok、MapStruct的注解处理逻辑，哪怕Maven插件配置不生效，IDE编译阶段也能正常生成MapStruct实现类、Lombok注解对应的getter/setter；但命令行执行mvn clean package打War包时，插件未被加载，注解处理器完全不会执行，MapStruct实现类不会写入target/classes目录，最终War包内不存在对应的Spring Bean，自然触发@Autowired注入失败。
• 解决操作：在 节点下新增独立的 块，显式声明maven-compiler-plugin，将原本配置在pluginManagement里的注解处理器路径、编译参数同步到实际生效的插件配置中。

2. 依赖版本兼容异常 #

• 配置的Lombok版本1.12.6为2014年发布的老旧版本，完全不兼容lombok-mapstruct-binding组件，会出现注解处理器执行顺序错乱、MapStruct无法识别Lombok生成的getter/setter的问题。
• 同时MapStruct 1.3.0.Final已停止维护，建议替换为稳定兼容的版本组合：
  • Lombok版本升级为1.18.30及以上，在 节点新增Lombok正式依赖，scope设置为provided，不可仅在注解处理器路径中配置Lombok
  • MapStruct版本升级为1.5.5.Final，将原有mapstruct-jdk8依赖替换为正式的mapstruct依赖，配套使用同版本mapstruct-processor
  • 保留lombok-mapstruct-binding 0.2.0的注解处理器配置，注意调整annotationProcessorPaths内的顺序：Lombok处理器 → lombok-mapstruct-binding → MapStruct处理器，确保注解处理顺序正确。
• 移除dependencies中重复引入的mapstruct-processor provided依赖，该能力已由编译插件的注解处理器路径接管，重复引入易引发类加载冲突。

3. 产物校验与扫描范围排查 #

• 解包生成的War文件，检查WEB-INF/classes目录下是否存在Mapper接口对应的实现类（命名规则为原接口名 + Impl，如MapperImpl.class）：
  • 若不存在该类，说明编译阶段注解处理器未正常执行，优先核对前两点的配置问题，确保打包时执行了完整的clean构建命令，避免STS生成的旧类残留导致环境不一致。
  • 若存在该类但启动仍然注入失败，检查Spring的@ComponentScan扫描范围，确保扫描路径覆盖了Mapper接口所在的包（MapStruct生成的实现类默认与Mapper接口处于同一包路径下）。

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