AutoMapper技术咨询：如何忽略源未提供的目标成员

嘿，这个问题我太熟了！很多后端开发者在处理DTO和Entity映射时都会碰到这个痛点——既要用DTO里的更新数据覆盖Entity对应字段，又得牢牢保住Entity里那些DTO没涉及的原有数据，绝对不能被误改。下面给你几个实用的方案，挑适合你项目场景的来用：

如果你的DTO字段不多，手动写setter是最靠谱的方式，完全由你掌控哪些字段被更新，根本不会出现误覆盖的情况。

举个例子：

// 先从数据库取出要更新的原有Entity
Item existingItem = itemRepository.findById(itemId).orElseThrow(() -> new RuntimeException("Item not found"));

// 客户端传来的DTO
ItemNameDto dto = ...;

// 只更新DTO中存在的字段，其他字段原封不动
existingItem.setItemName(dto.getItemName());
// 如果DTO还有其他字段，比如描述，就继续加：existingItem.setDescription(dto.getDescription());

// 最后保存回数据库
itemRepository.save(existingItem);

优点：逻辑直观，100%可控，不会有意外的字段覆盖；缺点：如果DTO字段很多，写起来有点繁琐，但胜在安全。

MapStruct是专门为Java Bean映射设计的工具，比Spring的BeanUtils智能太多，完美适配这种“只更新指定字段”的场景。

首先你需要在项目里引入MapStruct的依赖（Maven/Gradle都支持），然后定义一个映射接口：

@Mapper(componentModel = "spring") // 让Spring管理这个Mapper
public interface ItemMapper {
    // 把DTO的字段更新到已有Entity，忽略Entity里DTO没有的字段
    @Mapping(target = "id", ignore = true) // ID一般不需要从DTO更新，直接忽略
    void updateItemFromDto(ItemNameDto dto, @MappingTarget Item existingItem);
}

然后在业务代码里直接注入使用：

@Autowired
private ItemMapper itemMapper;

// 取出原有Entity
Item existingItem = itemRepository.findById(itemId).orElseThrow();
// 执行映射：只把DTO里的字段赋值到Entity，其他字段保持原样
itemMapper.updateItemFromDto(dto, existingItem);
// 保存更新
itemRepository.save(existingItem);

优点：自动化生成映射代码（编译时生成，性能和手动写一样），支持自定义映射规则、类型转换，还能通过注解精准控制哪些字段忽略；缺点：需要引入额外依赖，但这个成本完全值得。

很多人会用Spring自带的BeanUtils.copyProperties，但默认它会把DTO里的null值也覆盖到Entity里，所以必须封装一个工具类来过滤null字段：

public class BeanCopyUtil {
    public static void copyNonNullProperties(Object source, Object target) {
        BeanUtils.copyProperties(source, target, getNullPropertyNames(source));
    }

    private static String[] getNullPropertyNames(Object source) {
        BeanWrapper src = new BeanWrapperImpl(source);
        PropertyDescriptor[] pds = src.getPropertyDescriptors();
        
        Set<String> emptyPropertyNames = new HashSet<>();
        for (PropertyDescriptor pd : pds) {
            Object value = src.getPropertyValue(pd.getName());
            if (value == null) {
                emptyPropertyNames.add(pd.getName());
            }
        }
        return emptyPropertyNames.toArray(new String[0]);
    }
}

使用的时候：

Item existingItem = itemRepository.findById(itemId).orElseThrow();
// 只复制DTO中非null的字段，不会覆盖Entity原有数据
BeanCopyUtil.copyNonNullProperties(dto, existingItem);
itemRepository.save(existingItem);

注意：如果DTO里的字段有默认值（比如0、false），这些值也会覆盖Entity里的对应字段，所以只适合DTO字段都是可选、null代表不更新的场景。

如果你的项目里有大量这种DTO到Entity的部分更新需求，可以自己写一个反射工具类，遍历DTO的字段，只把非null的字段赋值到Entity：

public class DtoEntityMapper {
    public static void copyDtoToEntity(Object dto, Object entity) throws IllegalAccessException {
        Class<?> dtoClass = dto.getClass();
        Class<?> entityClass = entity.getClass();
        
        Field[] dtoFields = dtoClass.getDeclaredFields();
        for (Field dtoField : dtoFields) {
            dtoField.setAccessible(true);
            Object value = dtoField.get(dto);
            if (value != null) {
                try {
                    Field entityField = entityClass.getDeclaredField(dtoField.getName());
                    entityField.setAccessible(true);
                    entityField.set(entity, value);
                } catch (NoSuchFieldException e) {
                    // 如果Entity里没有对应字段，直接跳过
                    continue;
                }
            }
        }
    }
}

调用方式很简单：

Item existingItem = itemRepository.findById(itemId).orElseThrow();
DtoEntityMapper.copyDtoToEntity(dto, existingItem);
itemRepository.save(existingItem);

优点：通用型强，不用为每个DTO写映射逻辑；缺点：反射性能略差（一般业务场景可忽略），且要求DTO和Entity的字段名完全一致，否则映射失败。

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