本文介绍在 mapstruct 中避免使用 `@aftermapping`，转而利用 `expression` + 自定义默认方法实现基于多个源字段（如 `source.pac.temperature` 和 `source.range`）动态计算目标字段（如 `containerid`）的优雅映射方案。
在 MapStruct 中，当目标字段的值需依赖多个源属性的协同计算（例如 range.calculate(temperature)），而非简单的一对一映射时，常见的 @AfterMapping 方式虽可行，但会破坏映射逻辑的内聚性——它将字段级转换逻辑从声明式映射中剥离，降低了可读性与可测试性。
更推荐的做法是：在 Mapper 接口中定义一个 default 方法，接收完整源对象（如 Source），封装计算逻辑；再通过 @Mapping(expression = "java(...)") 直接调用该方法。这种方式保持了映射配置的声明式风格，且方法可独立单元测试。
以下为完整示例：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
@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) {
// 可安全访问 source 的任意嵌套属性
Double temperature = source.getPac().getTemperature();
Range range = source.getRange();
return range != null ? range.calculate(temperature) : null;
}
}✅ 优势说明：
- 类型安全：expression 中的 Java 代码在编译期由 MapStruct 解析校验（如方法存在、返回类型匹配）；
- 可复用：calculateContainerId() 可被其他映射方法复用，或直接在业务层调用；
- 易测试：无需启动 Spring 上下文，即可对 calculateContainerId() 进行纯单元测试；
- 无侵入：不强制要求修改 Source 或 Range 类，符合开闭原则。
⚠️ 注意事项：
- expression 中的 source 指代的是当前映射方法的第一个参数（即 Source source），命名必须一致；
- 若需访问 target 对象（如做条件覆盖），expression 不适用，此时仍应选用 @AfterMapping；
- 避免在 expression 中编写复杂逻辑（如多层 if/else、循环），应提取到 default 方法中以保证可维护性。
综上，对于“单目标字段依赖多源字段计算”的场景，expression + default method 是比 @AfterMapping 更清晰、更可测、更符合 MapStruct 设计哲学的首选方案。
