在 MapStruct 中，当需要仅在目标对象某字段不为 null 时才进行源字段映射（如避免覆盖已存在的 engine），不能依赖 ignore = "true" 配合 @AfterMapping 的原始写法——该方案逻辑错误且存在空指针风险；应改用 nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE 或条件化 @AfterMapping 进行安全赋值。
在 mapstruct 中，当需要仅在目标对象某字段不为 null 时才进行源字段映射（如避免覆盖已存在的 engine），不能依赖 `ignore = "true"` 配合 `@aftermapping` 的原始写法——该方案逻辑错误且存在空指针风险；应改用 `nullvaluepropertymappingstrategy = nullvaluepropertymappingstrategy.ignore` 或条件化 `@aftermapping` 进行安全赋值。
MapStruct 默认会对所有标注的 @Mapping 执行赋值操作，无论目标属性当前是否为 null。若希望“仅当目标对象的 engine 字段不为 null 时，才将 carDto.device 映射过去”，关键在于控制属性级的条件赋值逻辑，而非简单忽略映射。
✅ 推荐方案一：使用 NullValuePropertyMappingStrategy.IGNORE（全局/局部生效）
该策略可让 MapStruct 在源值为 null 时跳过目标属性赋值，但注意：它作用于 源值 是否为空，而非 目标值。因此需配合源端判空逻辑：
@Mapper(
nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE
)
public interface CarMapper {
@Mapping(target = "engine", source = "device")
void updateCarFromDto(CarDto carDto, @MappingTarget Car car);
}
此时若 carDto.getDevice() 返回 null，则 car.setEngine(null) 不会执行 —— 但这仍不满足“仅当 car.getEngine() != null 时才映射”的原始需求。
✅ 推荐方案二（精准匹配需求）：@AfterMapping + 显式目标判空（安全可靠）
这是最直接、可控的方式。需修正原答案中的逻辑缺陷（如 car.getEngine != null 缺少括号与方法调用，且未处理 carDto.getDevice() 为 null 的情况）：
@Mapper
public interface CarMapper {
// 先忽略 engine 的自动映射
@Mapping(target = "engine", ignore = true)
void updateCarFromDto(CarDto carDto, @MappingTarget Car car);
@AfterMapping
default void handleEngineMapping(
@MappingTarget Car car,
CarDto carDto) {
// 安全校验：目标 car 和源 device 均非 null，且目标 engine 已存在
if (car != null && carDto != null && car.getEngine() != null) {
car.setEngine(carDto.getDevice()); // 仅当 engine 已初始化时才更新
}
}
}
⚠️ 注意事项：
- @AfterMapping 方法参数顺序不影响逻辑，但建议按 @MappingTarget 在前、源对象在后的习惯书写；
- 必须显式判空 car.getEngine()（而非 car.getEngine != null），否则编译失败；
- 若 CarDto#getDevice() 可能为 null，而你又不希望用 null 覆盖现有 engine，当前逻辑已天然规避（因只在 car.getEngine() != null 时才赋值）；
- 避免在 @AfterMapping 中执行复杂业务逻辑，保持职责单一。
? 总结：MapStruct 本身不提供“目标非空才映射”的内置注解，但通过 ignore + @AfterMapping 组合，辅以严谨的空值检查，即可精准、安全地实现该语义。这是领域驱动映射中常见的防御性编程实践。
