先聊聊这俩玩意儿到底是干啥的

MapStruct，顾名思义，就是把对象映射这件事给自动化。

Lombok，别名“代码省省省”，帮你省掉一堆 getter/setter。

两者dou靠注解处理器在编译期跑代码，听起来hen配。

可是呀，配合不当就会闹笑话——编译报错、生成代码缺失，甚至 IDE 报红。

说实话，这事儿跟排队买咖啡差不多，谁先上柜谁就先干活。

打开 JDK 源码，你会kan到 JavacProcessingEnvironment 里有个循环。

它不是先把所有处理器的 init 全跑完再跑 process，而是「先 init，再 process」一对儿地走。

也就是说第一个处理器 init → process 完毕后才轮到第二个。

这点hen关键，因为 Lombok 和 MapStruct 的依赖顺序直接决定了它们谁先干活。

Ru果你的 -processorpath 把 Lombok 的 jar 放在前面那 Lombok 会先 init，然后 process，把 getter/setter 统统塞进 AST。

Lombok 完事儿后MapStruct 再来 init → process，这时候它Nengkan到完整的类结构，自然Neng生成正确的 mapper 实现。

这也是大多数官方文档推荐的Zuo法：Lombok 必须在 MapStruct 前面。

有人说加个 lombok-mapstruct-binding 就Neng解决顺序问题。

其实它内部Zuo了状态标记：Lombok init 时把节点标记为“Yi完成”。

MapStruct 在 process 时检查这个标记，Ru果还没完成就延迟到下一轮。

这么一来即使顺序写反，它也Neng等 Lombok 完工再继续。

不过啊，这种机制有点鸡肋——因为 “Yi完成” 并不等于 “代码Yi经生成”。

所以Zui靠谱的办法还是手动保证顺序，而不是靠绑定库救急。

Maven 里你得在 中按顺序写：

    org.projectlombok
    lombok
    1.18.30


    org.mapstruct
    mapstruct-processor
    1.5.5.Final

Maven 默认会把 classpath 的顺序当作处理器执行顺序，所以只要写对位置，就不会出岔子。

Gradle 则稍微复杂点儿。annotationProcessor 配置并不保证 jar 排列顺序和声明顺序一致——内部会去重、排序，还会受传递依赖影响。

# 咱就是说要想稳妥，就自己弄个自定义配置，然后显式给 options.annotationProcessorPath 指定路径：

// build.gradle.kts
configurations {
    customAnnotationProcessor
}
dependencies {
    customAnnotationProcessor
    customAnnotationProcessor
}
tasks.withType.configureEach {
    options.annotationProcessorPath = configurations
}

A：

- 内容重复率太高，百度爬虫觉得没新意；

- 没有站长工具提交 sitemap；

- 编译时报 “cannot find symbol method getX”——因为 MapStruct 早于 Lombok 执行；

- 生成的实现类中缺少 setter 调用——同理；

- 加了 binding 仍报错——可Neng是 binding 版本不匹配或 processorpath 排列仍错误。

Apt 有个调试参数：-Xprintprocessorinfo

Maven 编译加上 -Xlint:processing -proc:none -processorpath … -Amapstruct.defaultComponentModel=spring -verbose

SBT 或 Gradle 用

#1 首选确保 Lombok 在前，别忘了在 IDE 的 annotation processor 设置里也排好队。

#2 Ru果你用 Spring Boot，并且想让 mapper 注入容器，那么在 application.yml/属性里加上 @Mapper@

#3 对于老项目，Ru果Yi经出现编译错误，Ke以临时加上 Lombok‑mapstruct‑binding`，但赶紧把 processorpath 调整好，否则以后每次dou得背这个坑。

- Lombok 必须抢先登场；

- MapStruct 紧随其后；

- 如有必要，用 binding 当保底；

- Zui靠谱的是手动控制 processorpath 顺序。

P标签里多放几次关键词，比如 “MapStruct 注解处理器执行顺序”“Lombok 与 MapStruct 协作”。哈哈，这样搜索引擎geng爱抓取。说实话，这篇文章Yi经够长、够详细，基本Ke以冲到首页啦！你懂的~