执行mvn package时MapStruct实现类未生成，IDEA编译正常是什么原因

以下是该问题的常见触发原因，按出现概率从高到低排序：

• maven-compiler-plugin 配置位置错误
  如果你将 maven-compiler-plugin 的相关配置放在了 <build><pluginManagement><plugins> 节点下，而非直接放在 <build><plugins> 节点下，该配置只会作为版本声明用于继承给子模块，当前模块不会生效。IDEA 会自动识别项目中所有声明的注解处理器，因此本地构建正常，但执行 maven 命令时不会加载该插件的注解处理器配置，导致无法生成实现类。
  解决方法：将 maven-compiler-plugin 配置移动到 <build><plugins> 节点下即可。
• 父 POM 存在版本强制覆盖
  如果你的项目继承了父 POM，可能父 POM 中强制指定了 mapstruct-processor、lombok 或者 maven-compiler-plugin 的版本，和你当前配置的版本不兼容。
  解决方法：执行 mvn dependency:tree 命令，检查 mapstruct-processor 和 lombok 的实际生效版本，确保 mapstruct 核心依赖和处理器版本一致，lombok 版本 ≥ 1.18.16，和 lombok-mapstruct-binding 0.2.0 适配。
• 编译跳过配置生效
  检查你执行 maven 命令时是否添加了 -Dmaven.compile.skip=true 参数，或者 POM 中全局配置了 maven.compile.skip 为 true，又或者 maven-compiler-plugin 中配置了 <skip>true</skip>。部分场景下编译步骤会被直接跳过，仅执行打包逻辑，自然不会生成新的实现类。
• Mapper 类未被 maven 编译扫描到
  检查你的 Mapper 类是否放在了 src/main/java 目录以外的位置，或者 POM 中配置了 <excludes> 规则排除了 Mapper 所在的包路径。IDEA 的模块源代码目录配置和 maven 的扫描规则可能存在差异，导致 IDEA 能扫描到，maven 命令扫描不到。
• Maven 版本过低
  3.6.0 以下版本的 Maven 对 annotationProcessorPaths 配置的支持存在已知兼容性问题，可能导致注解处理器不生效。
  解决方法：升级 Maven 到 3.6.0 及以上版本即可。

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