本文介绍如何在 MapStruct 中定义轻量级自定义映射器——利用自动属性映射机制，仅通过 @AfterMapping 或 @BeforeMapping 处理少数需转换的字段，避免重复编写大量 @Mapping 声明。
本文介绍如何在 mapstruct 中定义轻量级自定义映射器——利用自动属性映射机制，仅通过 `@aftermapping` 或 `@beforemapping` 处理少数需转换的字段，避免重复编写大量 `@mapping` 声明。
MapStruct 的核心优势之一是约定优于配置：当源对象与目标对象存在同名、同类型（或可兼容）的字段时，MapStruct 会在编译期自动生成赋值代码，无需任何显式 @Mapping 注解。这意味着，只要 DTO1 和 DTO2 的大部分字段命名一致（或已通过少量 @Mapping 映射好），你只需聚焦于“例外逻辑”——例如某个字段需经函数加工、需条件赋值、或需从多个源字段组合生成。
此时，@AfterMapping 是最简洁高效的解决方案。它允许你在默认映射完成之后，对目标对象进行补充操作，且仅需编写真正需要干预的逻辑：
@Mapper
public abstract class DtoMapper {
// 声明一个需重命名的字段（唯一显式 @Mapping）
@Mapping(target = "desiredName", source = "notDesiredName")
// 主映射方法（MapStruct 自动生成其余同名字段赋值）
public abstract Dto2 toDto2(Dto1 dto1);
// 仅处理特殊字段：在默认映射完成后修改 dto2.somethingThatChanges
@AfterMapping
protected void interveneWithSomethingThatChanges(
Dto1 dto1,
@MappingTarget Dto2 dto2) {
dto2.somethingThatChanges = dto1.somethingThatChanges + ": changed";
}
}
✅ 注意事项：
- @MappingTarget 参数必须标注在目标对象参数上，否则 MapStruct 无法识别上下文；
- @AfterMapping 方法必须是 protected 或 public，且不能是 static；
- 若需在映射前预处理（如初始化目标对象、校验源数据），可改用 @BeforeMapping；
- 所有未显式声明或未被 @AfterMapping 覆盖的同名字段，均由 MapStruct 自动完成浅拷贝；
- 若存在类型不匹配但语义可转换的字段（如 LocalDateTime ↔ String），应配合 @Mapper(uses = {...}) 引入自定义转换器，而非在 @AfterMapping 中硬编码格式化逻辑。
最后，使用工厂方式获取 mapper 实例并调用：
DtoMapper mapper = Mappers.getMapper(DtoMapper.class);
Dto1 dto1 = new Dto1("value", "unchanged", "renamed");
Dto2 dto2 = mapper.toDto2(dto1); // 自动映射 + 后置增强
输出验证了效果：somethingThatChanges 已被增强，其余字段（包括重命名字段 desiredName）均正确传递。这种模式显著提升了映射代码的可维护性——新增字段时，只要命名规范，几乎零配置；变更逻辑时，也只需定位到单一 @AfterMapping 方法，彻底告别冗长而脆弱的全量字段映射声明。
