Mapstruct 1.5.2.Final中忽略Null对象与字段失效求助

问题根源分析 #

你当前配置的NullValuePropertyMappingStrategy.IGNORE仅作用于更新已有DTO对象的场景：当用源Entity更新一个已存在的DTO时，若Entity的某个属性为null，不会覆盖DTO对应属性的原有值。但你的两个问题对应不同的空值处理场景，需要补充针对性配置：

• 源对象本身为null时返回空DTO而非null：这是MapStruct默认行为，需调整全局映射策略
• 源属性为null时DTO属性未保持null：需排查DTO字段默认值、生成代码逻辑或编译缓存问题

具体解决方案 #

1. 处理源对象为null的场景 #

修改@Mapper注解，添加nullValueMappingStrategy配置，确保源对象为null时直接返回null，而非生成空的DTO对象：

@Mapper( 
    nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE,
    nullValueMappingStrategy = NullValueMappingStrategy.RETURN_NULL
)
public interface PacketItemInstanceMapper {
    PacketItemInstanceMapper INSTANCE = Mappers.getMapper(PacketItemInstanceMapper.class);
    
    PacketItemInstanceDTO toDTO(PacketItemInstance entity);
    List<PacketItemInstanceDTO> toDTO(List<PacketItemInstance> entities);
    
    default PacketItemInstanceDTO getFirstDTO(List<PacketItemInstance> entities){
        if(CollectionUtils.isEmpty(entities)){
            return null;
        }
        return toDTO(entities.get(0));
    }
}

2. 处理源属性为null的校验问题 #

• 检查PacketItemInstanceDTO的effectiveDate字段是否存在默认值（比如类内初始化、构造器赋值），若有则在映射方法上显式指定空值处理规则：

  @Mapping(target = "effectiveDate", nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.SET_TO_NULL)
  PacketItemInstanceDTO toDTO(PacketItemInstance entity);
  

• 查看MapStruct生成的实现类（路径一般为build/generated/sources/apt/main/[你的包路径]/PacketItemInstanceMapperImpl.java），确认effectiveDate的赋值逻辑。若存在错误的非空赋值，执行Gradle clean任务后重新构建，排除增量编译缓存影响：

  ./gradlew clean build
  

内容的提问来源于stack exchange，提问作者Aykut MÜNÜK