如何监控MapStruct的映射器代码生成耗时？

好问题！我之前也帮团队排查过类似的MapStruct构建慢的问题，刚好有几个实用的方法能帮你精准定位每个Mapper的生成耗时，找到瓶颈后再针对性调优：

一、开启MapStruct verbose日志追踪单个Mapper耗时 #

MapStruct本身支持输出详细的生成日志，包括每个Mapper类的开始/结束生成时间，你只需要在Gradle的编译任务里给注解处理器添加参数：

tasks.withType(JavaCompile) {
    options.compilerArgs += [
        "-Amapstruct.verbose=true", // 开启MapStruct详细日志
        "-Xlog:processor=debug"     // 开启Java编译器注解处理器调试日志
    ]
}

运行构建后，你可以在控制台日志里找到类似这样的输出：

[DEBUG] MapStruct: Generating implementation for com.yourpackage.UserMapper
[DEBUG] MapStruct: Finished generating implementation for com.yourpackage.UserMapper in 120ms

通过这些日志，你就能统计出每个Mapper的生成耗时，直接定位到拖慢速度的那个类。

二、用Gradle构建扫描（Build Scan）可视化分析 #

如果你的Gradle版本在4.3及以上，构建扫描是更直观的方式——它会自动统计所有注解处理器的执行时间，包括每个Mapper类的处理耗时。

只需要运行构建时加上--scan参数：

./gradlew build --scan

生成的扫描报告里，找到「Annotation Processing」板块，就能看到每个Mapper类对应的处理时长、占比，甚至能对比不同构建的耗时变化，非常适合快速定位瓶颈。

三、定位瓶颈后的调优建议 #

当你找到耗时最长的Mapper后，可以从这几个方向优化：

• 拆分复杂Mapper：如果某个Mapper包含大量嵌套映射、自定义转换器或循环引用逻辑，拆分成多个小Mapper能显著减少单次生成的工作量。
• 复用映射配置：多个Mapper共用的自定义转换器、类型映射规则，提取到单独的@Mapper接口中，通过uses属性引用，避免重复生成相同代码。
• 开启增量编译：确保Gradle开启了增量编译（Gradle 5.0+默认开启，旧版本需手动配置java.compileOptions.incremental = true），这样每次构建只会重新生成修改过的Mapper类，大幅减少重复工作。
• 尝试升级MapStruct版本：虽然你说1.2版本没改善，但1.3及以后的版本针对大量Mapper场景做了不少性能优化（比如增量生成支持、生成逻辑精简），可以试试升级到最新稳定版（比如1.5.x），说不定能带来整体速度提升。

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