MapStruct的NullValuePropertyMappingStrategy.IGNORE为何重置未指定布尔值为false？

使用MapStruct的nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE配置更新目标对象时，该策略能忽略源对象的空值，但对布尔类型无效：当源对象的布尔属性未指定具体值时，目标对象对应属性会被设为false。希望实现无需手动空值检查的补丁更新功能，怀疑是配置遗漏或Lombok导致的问题。

相关代码 #

Mapper接口 #

@Mapper(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE, nullValueCheckStrategy= NullValueCheckStrategy.ALWAYS)
public interface  StoreMapper {
    StoreMapper INSTANCE = Mappers.getMapper(StoreMapper.class);

    @Mapping(target="id", source="id", ignore=true)
    void updateStoreFromUpdateStoreDto(UpdateStoreDto source, @MappingTarget Store store);
}

POM依赖片段 #

<org.mapstruct.version>1.6.3</org.mapstruct.version>
<lombok.version>1.18.30</lombok.version>

<path>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>${org.mapstruct.version}</version>
</path>
<path>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>${lombok.version}</version>
</path>
<path>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok-mapstruct-binding</artifactId>
    <version>0.2.0</version>
</path>

核心原因 #

Java基本类型boolean的默认值是false，MapStruct会将未显式赋值的boolean属性视为有效值false而非null，因此nullValuePropertyMappingStrategy.IGNORE不会触发忽略逻辑——该策略仅对null值生效。

方案1：改用布尔包装类Boolean #

将UpdateStoreDto中的boolean类型字段改为包装类Boolean，未赋值时字段值为null，此时MapStruct会识别并应用IGNORE策略：

// 修改后的UpdateStoreDto示例
public class UpdateStoreDto {
    private Boolean enabled; // 用Boolean替代boolean
    // 其他字段...
}

方案2：自定义条件判断（无法修改类型时） #

使用MapStruct的@Condition注解自定义检查逻辑，判断源对象的布尔属性是否需要映射：

@Mapper(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE, nullValueCheckStrategy= NullValueCheckStrategy.ALWAYS)
public interface StoreMapper {
    StoreMapper INSTANCE = Mappers.getMapper(StoreMapper.class);

    @Mapping(target="id", source="id", ignore=true)
    void updateStoreFromUpdateStoreDto(UpdateStoreDto source, @MappingTarget Store store);

    // 自定义条件：仅当源属性被显式标记为需要更新时才映射
    @Condition
    default boolean shouldMapBoolean(boolean sourceValue, boolean isUpdateFlag) {
        return isUpdateFlag;
    }
}

注：需给DTO添加额外标记字段（如updateEnabled）来区分“未赋值的默认false”和“主动设置的false”，避免合法更新被忽略。

方案3：确认Lombok与MapStruct绑定配置 #

当前使用的lombok-mapstruct-binding:0.2.0适配MapStruct 1.4+和Lombok 1.18.16+，版本组合兼容。需确保IDE中Lombok和MapStruct插件均已启用，避免编译生成的代码不符合预期。

内容的提问来源于stack exchange，提问作者Sael Torres-Diaz