本文介绍如何在 mapstruct 中摆脱 `@aftermapping`，改用 `expression="java(...)"` 直接在 `@mapping` 中调用含多参数逻辑的自定义方法，实现更清晰、更内聚的字段映射。
在 MapStruct 中，当目标字段的值依赖于源对象中多个嵌套属性（如 source.getPac().getTemperature() 和 source.getRange()）时，单纯依靠 source.xxx 路径无法满足需求。此时，@AfterMapping 虽然可行，但会将映射逻辑与结构转换分离，降低可读性与可测试性。
更推荐的做法是：在 Mapper 接口内声明 default 方法封装计算逻辑，并通过 expression 属性直接调用该方法。该方法接收完整的源对象（Source），内部自由访问任意字段或嵌套结构，返回目标字段所需值。
以下是完整示例：
@Mapper
public interface SourceToTargetMapper {
@Mapping(target = "temperature", source = "pac.temperature")
@Mapping(target = "containerId", expression = "java(calculateContainerId(source))")
TargetABC toDto(Source source);
default String calculateContainerId(Source source) {
// 可安全访问任意嵌套属性，无需担心空指针（业务层应保障数据完整性）
Double temperature = source.getPac().getTemperature();
Range range = source.getRange();
return range != null ? range.calculate(temperature) : null;
}
}✅ 优势说明：
- 语义集中：containerId 的计算逻辑紧贴其映射声明，一目了然；
- 类型安全：编译期校验方法存在性与返回类型，避免运行时 SpEL 表达式错误；
- 可复用 & 可测：calculateContainerId() 是普通 Java 方法，支持单元测试、调试和重用；
- 无侵入性：不依赖 @Named / qualifiedByName 等复杂限定机制，也无需额外参数传递——因为 source 已天然包含全部上下文。
⚠️ 注意事项：
- expression 中的 Java 代码需为单条表达式语句（支持三元运算、方法调用、简单逻辑，但不支持多行语句或声明变量）；
- 方法必须为 default（接口中）或 protected（抽象类中），且不能是静态方法（MapStruct 仅代理实例方法）；
- 若涉及可能为空的对象（如 pac 或 range），建议在 default 方法内做空值防护，避免 NullPointerException；
- 避免在 expression 中写冗长逻辑——应始终提取为命名清晰的 default 方法，保持表达式简洁。
总结：相比 @AfterMapping 或复杂的 @Named + qualifiedByName 组合，expression="java(...)" 调用 default 方法是最轻量、最直观、最符合 MapStruct 设计哲学的解决方案。它让映射配置真正“声明式”起来，同时保留 Java 的完整表达能力与工程可控性。
