在使用 MapStruct 进行对象更新时，若目标对象（如 Car）的某个字段（如 engine）为 null，可通过组合 @Mapping(ignore = true) 与 @AfterMapping 自定义逻辑，实现“仅当目标非空时才执行映射”的条件式赋值。
在使用 mapstruct 进行对象更新时，若目标对象（如 `car`）的某个字段（如 `engine`）为 `null`，可通过组合 `@mapping(ignore = true)` 与 `@aftermapping` 自定义逻辑，实现“仅当目标非空时才执行映射”的条件式赋值。
MapStruct 默认会对所有标注了 @Mapping 的字段进行无条件映射，但实际业务中常需更精细的控制——例如：仅当目标对象的某字段已初始化（非 null）时，才用源对象对应值更新它；若目标字段为空，则跳过赋值，避免覆盖为 null 或破坏原有状态。
上述需求无法仅靠 @Mapping(target = "engine", source = "device") 实现，因为该声明始终触发映射。正确做法是先禁用默认映射，再通过 @AfterMapping 方法手动插入条件判断逻辑：
@Mapper
public interface CarMapper {
@Mapping(target = "engine", ignore = true) // 完全跳过 engine 字段的自动生成映射
void updateCarFromDto(CarDto carDto, @MappingTarget Car car);
@AfterMapping
default void updateEngineIfTargetExists(CarDto carDto, @MappingTarget Car car) {
// 安全校验：确保 car 和 carDto 非 null，且 car.engine 已存在（非 null）
if (car != null && carDto != null && car.getEngine() != null) {
car.setEngine(carDto.getDevice());
}
}
}
⚠️ 注意事项：
- @Mapping(ignore = true) 是必需的起点，否则 MapStruct 会生成强制赋值代码，覆盖后续 @AfterMapping 的逻辑；
- @AfterMapping 方法必须是 default 方法（接口内），且参数顺序需与主映射方法一致（源在前、@MappingTarget 在后）；
- 显式判空（car.getEngine() != null）是关键，它实现了“目标非空才更新”的语义；
- 若 engine 是复杂嵌套对象，还可进一步扩展判断逻辑（如检查其内部状态）；
- 此方案保持了 MapStruct 的编译期安全性和性能优势，无需反射或运行时代理。
总结：MapStruct 本身不支持“条件性字段映射”语法（如 if target != null），但通过 ignore + @AfterMapping 的组合模式，可精准、清晰、类型安全地实现按需更新逻辑，是处理此类场景的标准实践。
