如何避免Mapper中Entity与DTO公共字段的浅拷贝问题？

以下是几种无需拆分Option类的可行解决方案：

1. 自定义深拷贝映射方法 #

在MapStruct Mapper接口中为Option字段定义专属的深拷贝逻辑，MapStruct会自动调用该方法替代默认的浅拷贝赋值。

示例代码：

@Mapper
public interface EntityDtoMapper {
    EntityDtoMapper INSTANCE = Mappers.getMapper(EntityDtoMapper.class);

    @Mapping(target = "option", source = "option", qualifiedByName = "deepCopyOption")
    Dto entityToDto(Entity entity);

    @Named("deepCopyOption")
    default Option deepCopyOption(Option source) {
        if (source == null) {
            return null;
        }
        Option target = new Option();
        // 手动拷贝Option的所有字段
        target.setField1(source.getField1());
        target.setField2(source.getField2());
        // 若Option包含其他引用类型字段，需递归拷贝
        return target;
    }
}

这种方式可读性强，后续新增字段时只需在deepCopyOption方法中补充拷贝逻辑即可。

2. 利用构造器/Builder模式创建新对象 #

如果Option类提供全参构造器或Builder（比如Lombok的@Builder），可以直接在映射表达式中创建新的Option实例：

全参构造器示例： #

@Mapper
public interface EntityDtoMapper {
    EntityDtoMapper INSTANCE = Mappers.getMapper(EntityDtoMapper.class);

    @Mapping(target = "option", expression = "java(new Option(entity.getOption().getField1(), entity.getOption().getField2()))")
    Dto entityToDto(Entity entity);
}

Builder模式示例（Lombok）： #

@Mapping(target = "option", expression = "java(Option.builder().field1(entity.getOption().getField1()).field2(entity.getOption().getField2()).build())")
Dto entityToDto(Entity entity);

适合字段较少的Option类，字段过多时会导致表达式冗长。

3. 基于Cloneable接口实现深拷贝 #

修改Option类实现Cloneable接口并重写clone方法（需确保实现真正的深拷贝，若包含其他引用类型字段需递归克隆）：

public class Option implements Cloneable {
    // 字段、getter/setter

    @Override
    protected Option clone() throws CloneNotSupportedException {
        Option cloned = (Option) super.clone();
        // 若存在嵌套引用类型字段，需手动克隆
        // cloned.setNestedObj(this.getNestedObj().clone());
        return cloned;
    }
}

在Mapper中调用clone方法：

@Mapper
public interface EntityDtoMapper {
    EntityDtoMapper INSTANCE = Mappers.getMapper(EntityDtoMapper.class);

    @Mapping(target = "option", expression = "java(entity.getOption() != null ? entity.getOption().clone() : null)")
    Dto entityToDto(Entity entity) throws CloneNotSupportedException;
}

注意：clone方法会抛出CloneNotSupportedException，可在Mapper中通过default方法捕获异常，避免上层代码处理：

default Dto safeEntityToDto(Entity entity) {
    try {
        return entityToDto(entity);
    } catch (CloneNotSupportedException e) {
        throw new RuntimeException("Failed to clone Option", e);
    }
}

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