本文详解如何在 mapstruct 中通过 `expression` 调用带多参数逻辑的自定义方法，实现更清晰、可测试、声明式更强的字段级映射。
在 MapStruct 映射中，当目标字段（如 containerId）的值需依赖源对象多个嵌套属性（如 source.pac.temperature 和 source.range）协同计算时，传统做法常使用 @AfterMapping 进行后置赋值。虽然可行，但该方式将映射逻辑从声明式配置中剥离，降低了可读性与单元测试友好性，也违背了“映射即配置”的设计初衷。
MapStruct 提供了更优雅的替代方案：在 @Mapping 中直接通过 expression 属性内联调用自定义默认方法。该方法接收整个源对象（Source），内部自由访问任意嵌套属性并执行复杂逻辑，最终返回目标值。这种方式既保持了映射配置的集中性，又完全支持 IDE 自动补全、编译期校验和独立单元测试。
以下为推荐实现：
@Mapper
public interface SourceToTargetMapper {
@Mappings({
@Mapping(target = "temperature", source = "pac.temperature"),
@Mapping(target = "containerId", expression = "java(calculateContainerId(source))")
})
TargetABC toDto(Source source);
// 默认方法：可访问 source 全量状态，支持任意业务逻辑
default String calculateContainerId(Source source) {
if (source == null || source.getPac() == null || source.getRange() == null) {
return null; // 或抛出异常，依业务策略而定
}
Double temperature = source.getPac().getTemperature();
Range range = source.getRange();
return range.calculate(temperature);
}
}✅ 优势说明：
- 声明式统一：所有字段映射规则（包括计算逻辑）均显式声明在 @Mapping 中；
- 类型安全 & 可调试：calculateContainerId() 是普通 Java 方法，支持断点调试、Javadoc 注释、Mock 测试；
- 无反射开销：MapStruct 在编译期生成纯 Java 代码，expression 内联调用零运行时成本；
- 灵活扩展：方法体内可引入服务、调用工具类、处理空值、添加日志等，不受 MapStruct 注解限制。
⚠️ 注意事项：
- expression 中的 source 指代的是当前映射方法的第一个参数（即 Source source），命名固定，不可更改；
- 若需访问多个源对象（如多参数映射方法），expression 仍仅能引用方法签名中的首个参数，此时建议回归 @AfterMapping 或重构为单参数包装类；
- 避免在 expression 中书写过长逻辑（如多行条件判断），应封装进默认方法以保障可维护性；
- 确保自定义方法为 default 或 static（若为 static，需在 @Mapper 中通过 uses = {YourHelper.class} 引入）。
综上，expression = "java(...)" + 默认方法是替代 @AfterMapping 实现多源字段组合映射的最佳实践——它让映射逻辑既声明清晰，又具备完整的工程化能力。
