在 MapStruct 中，当目标对象的某个字段（如 engine）为 null 时，若希望跳过对其赋值（即不将源字段 device 映射过去），不能仅依赖 @Mapping(ignore = true) 简单屏蔽，而需结合 @AfterMapping 手动控制逻辑，确保空安全与业务意图一致。
在 mapstruct 中，当目标对象的某个字段（如 `engine`）为 null 时，若希望跳过对其赋值（即不将源字段 `device` 映射过去），不能仅依赖 `@mapping(ignore = true)` 简单屏蔽，而需结合 `@aftermapping` 手动控制逻辑，确保空安全与业务意图一致。
MapStruct 默认执行的是“覆盖式”映射：只要源字段有值、目标字段被声明为映射目标，就会无条件赋值。因此，@Mapping(target = "engine", source = "device") 在 car.getEngine() 为 null 时仍会将 carDto.getDevice() 写入，这往往违背“仅更新非空字段”的业务需求。
正确做法是分离声明式映射与条件逻辑：
- 先用 @Mapping(target = "engine", ignore = true) 显式排除自动映射；
- 再通过 @AfterMapping 添加自定义逻辑，在运行时按需判断并赋值。
以下是优化后的完整示例：
@Mapper
public interface CarMapper {
@Mapping(target = "engine", ignore = true) // 屏蔽默认映射
void updateCarFromDto(CarDto carDto, @MappingTarget Car car);
@AfterMapping
default void updateEngineIfTargetNotNull(CarDto carDto, @MappingTarget Car car) {
// 安全校验：避免 NPE
if (car == null || carDto == null) {
return;
}
// 关键逻辑：仅当目标 engine 非 null 时才更新
if (car.getEngine() != null && carDto.getDevice() != null) {
car.setEngine(carDto.getDevice());
}
// ⚠️ 注意：若需「engine 为 null 时保留原值」，此处无需 else 分支；
// 若需「engine 为 null 时才设置 device」，则改为 `if (car.getEngine() == null)`
}
}
? 关键注意事项：
- @AfterMapping 方法必须是 default 方法（接口中允许），且参数顺序需与主映射方法一致（源在前，@MappingTarget 在后）；
- 条件判断应同时校验 car.getEngine() 和 carDto.getDevice()，防止空指针或意外覆盖；
- ignore = true 仅禁用自动生成的赋值语句，不会影响 @AfterMapping 的手动操作，二者协同才能精准控制行为；
- 若业务语义是“仅当目标字段已存在时才更新”，上述逻辑即正确；若语义是“目标字段为空时才初始化”，请将条件改为 if (car.getEngine() == null)。
该方案保持了 MapStruct 的编译期安全性与性能优势，同时赋予开发者对映射流程的完全掌控力，是处理条件化字段更新的最佳实践。
