MapStruct嵌套类型自定义映射与默认映射共存问题咨询

首先，你遇到的问题根源是MapStruct的规则：当给某个字段（比如nested）明确指定自定义映射（通过qualifierByName）时，它会认为你要完全接管这个字段的转换逻辑，不再自动递归处理子类型的其他字段。不用手动逐个加@Mapping的共存方案分两种情况：

情况1：自定义方法仅处理嵌套对象里的单个字段 #

如果getValueForCustomField只是用来转换nestedData里的某一个特定字段（比如某个Integer类型字段），不要给整个nested字段加映射，直接给嵌套对象内的目标字段指定映射：

@Mapper(componentModel = "spring", builder = @Builder(disableBuilder = true))
public interface YourMapper {
    @Mapping(target = "nested.targetCustomField", source = "dto.nestedData.sourceCustomField", qualifierByName = "f")
    Result convertDtoToResult(DTO dto);

    @Named("f")
    default Integer getValueForCustomField(Integer input) {
        // 你的自定义转换逻辑
        return input != null ? input * 2 : null;
    }
}

这种方式下，MapStruct依然会自动映射nested里的其他所有字段，只有指定的字段用你自定义的方法。

情况2：自定义方法需处理整个嵌套对象，但保留大部分默认映射 #

如果需要对整个nestedData转换后的nested对象做特定修改，同时保留其他字段的默认映射，可以让MapStruct先自动生成嵌套对象的默认转换方法，再在自定义方法里调用它：

@Mapper(componentModel = "spring", builder = @Builder(disableBuilder = true))
public interface YourMapper {
    @Mapping(target = "nested", source = "dto.nestedData", qualifierByName = "f")
    Result convertDtoToResult(DTO dto);

    // 让MapStruct自动生成嵌套对象的默认转换方法
    Result.Nested convertNestedDataToNested(DTO.NestedData nestedData);

    @Named("f")
    default Result.Nested getValueForCustomField(DTO.NestedData input) {
        // 先调用默认转换，拿到已映射好大部分字段的对象
        Result.Nested nested = convertNestedDataToNested(input);
        // 在这里修改需要自定义的字段
        nested.setCustomField(你的自定义逻辑处理(input.getCustomField()));
        return nested;
    }
}

这种方式既利用了MapStruct的自动映射能力处理多数字段，又能通过自定义方法修改特定内容，无需手动逐个编写@Mapping。

另外关于你提到的Lombok Builder问题，用@Builder(disableBuilder = true)禁用MapStruct的生成器是正确的做法，能有效避免和Lombok的Builder冲突。

内容的提问来源于stack exchange，提问作者Draaksward