MapStruct生成更新ConsultationBO的映射方法体为空问题排查

问题原因 #

MapStruct 默认对 @MappingTarget 的更新操作，依赖目标类的setter方法或可变字段完成属性赋值。但你的目标类 ConsultationBO 是不可变类（通常字段为 final、无setter、仅通过构造函数初始化），MapStruct 无法通过常规方式修改已有实例的属性，因此仅生成空判断逻辑，无法生成实际映射代码。

而普通转换方法（如 consultationAPIModelToConsultationBO）是创建新对象，可直接利用构造函数完成映射，这也是这类方法能正常工作的原因。

解决办法 #

因要求保持 ConsultationBO 不可变，不能添加setter或修改字段可变性，提供两种可行方案：

方案1：自定义更新逻辑，返回新的不可变对象 #

利用不可变类的构造函数，结合源对象的新属性与目标对象的原有属性，创建并返回新的 ConsultationBO 实例：

@Mapper
public interface ConsultationMapper {
    // 普通转换方法（正常工作）
    ConsultationBO consultationAPIModelToConsultationBO(Consultation source);

    // 自定义更新逻辑：合并原BO与新API数据，返回新BO
    default ConsultationBO updateConsultationBOWithConsultationAPIModel(Consultation source, @MappingTarget ConsultationBO target) {
        if (source == null) {
            return target;
        }
        // 优先使用source的新值，无新值则保留target原有属性
        return new ConsultationBO(
            source.getId() != null ? source.getId() : target.getId(),
            source.getName() != null ? source.getName() : target.getName(),
            // 其他属性按此逻辑逐一处理
            target.getFixedProperty() // 无需更新的属性直接保留原有值
        );
    }
}

方案2：利用MapStruct的Builder支持（若ConsultationBO有Builder） #

如果 ConsultationBO 通过Builder模式实现不可变性（比如Lombok的 @Builder+@Value），可配置MapStruct借助Builder生成更新逻辑：

1. 确保 ConsultationBO 支持从已有实例创建Builder：

@Value
@Builder(toBuilder = true) // 开启toBuilder，允许基于已有实例生成Builder
public class ConsultationBO {
    private String id;
    private String name;
    // 其他字段
}

2. 在Mapper中启用Builder支持：

@Mapper(builder = @Builder(disableBuilder = false))
public interface ConsultationMapper {
    // 普通转换方法
    ConsultationBO consultationAPIModelToConsultationBO(Consultation source);

    // MapStruct自动利用toBuilder生成更新逻辑，返回新的BO实例
    ConsultationBO updateConsultationBOWithConsultationAPIModel(Consultation source, @MappingTarget ConsultationBO target);
}

MapStruct会自动生成代码：先通过 target.toBuilder() 创建Builder，将source的属性赋值给Builder，最后构建新的 ConsultationBO 实例。

注意事项 #

• 两种方案本质都是创建新的不可变对象，符合不可变类的设计原则（不可变类本身不允许修改已有实例）。
• 方案2要求 ConsultationBO 的Builder支持从已有实例生成，否则MapStruct无法生成对应逻辑。

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