MapStruct 最佳实践模式

来源: MapStruct Reference Guide | GitHub: mapstruct/mapstruct

Capability Boundaries

✅ Strong Suits

1. Mapper 三种定义方式 — 接口(标准) / 抽象类(需要字段) / default方法(自定义逻辑)
2. Spring 注入策略 — CONSTRUCTOR(推荐，测试友好) / SETTER(解决循环依赖)
3. 嵌套映射模式 — 显式子方法封装(推荐) > dot notation 一次性配置
4. @Qualifier vs @Named — 自定义 @Qualifier 注解(IDE重构安全) > @Named(字符串不安全)
5. Lombok 集成 — annotationProcessorPaths 中 Lombok 必须在 MapStruct 之前
6. @MappingComposition — 组合注解复用，但 error messages 不成熟需谨慎

❌ Out of Scope

1. 运行时动态 Bean 映射(Orika/Dozer) → MapStruct 编译期生成，不是反射

核心模式