刚好之前处理过类似的MapStruct一对多关联更新场景，我来给你一步步拆解怎么实现，完美匹配你的实体和DTO结构！

我们要达成的目标是：用ParentDTO更新数据库中已有的ParentEntity时，把DTO里的ChildDto列表和现有ChildEntity列表做合并——匹配ID更新现有子实体、新增无ID的子实体、按需移除DTO中不存在的子实体，同时维护好双向关联（子实体的myParent字段），还要忽略子实体里的非映射字段。

1. 定义MapStruct Mapper接口 #

这个接口是核心，我们会用自定义逻辑处理集合合并，同时让MapStruct帮我们处理基础字段的映射：

import org.mapstruct.AfterMapping;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.MappingTarget;
import java.util.ArrayList;
import java.util.Map;
import java.util.function.Function;
import java.util.stream.Collectors;

@Mapper(componentModel = "spring") // 用Spring组件模型，方便注入使用
public interface ParentChildMapper {

    // 忽略children的自动映射，我们用自定义逻辑处理
    @Mapping(target = "children", ignore = true)
    void updateParentEntityFromDto(ParentDTO dto, @MappingTarget ParentEntity existingParent);

    // 更新单个子实体，明确忽略非映射字段，避免DTO覆盖这些值
    @Mapping(target = "notMappedField1", ignore = true)
    @Mapping(target = "notMappedField2", ignore = true)
    void updateChildEntityFromDto(ChildDto dto, @MappingTarget ChildEntity existingChild);

    // 从ChildDto创建新的ChildEntity，同样忽略非映射字段
    @Mapping(target = "notMappedField1", ignore = true)
    @Mapping(target = "notMappedField2", ignore = true)
    ChildEntity childDtoToChildEntity(ChildDto dto);

    // 父实体基础字段更新完成后，执行子实体列表的合并逻辑
    @AfterMapping
    default void afterUpdateParent(@MappingTarget ParentEntity existingParent, ParentDTO dto) {
        mergeChildren(dto, existingParent);
    }

    // 自定义子实体列表合并逻辑
    default void mergeChildren(ParentDTO dto, @MappingTarget ParentEntity existingParent) {
        // 把现有子实体转成ID-实体的Map，方便快速匹配
        Map<Long, ChildEntity> existingChildMap = existingParent.getChildren().stream()
                .collect(Collectors.toMap(ChildEntity::getId, Function.identity()));

        List<ChildEntity> updatedChildren = new ArrayList<>();

        for (ChildDto childDto : dto.getChildren()) {
            if (childDto.getId() != null && existingChildMap.containsKey(childDto.getId())) {
                // 匹配到现有子实体，执行字段更新
                ChildEntity existingChild = existingChildMap.remove(childDto.getId());
                updateChildEntityFromDto(childDto, existingChild);
                updatedChildren.add(existingChild);
            } else {
                // 无匹配ID，创建新子实体并维护双向关联
                ChildEntity newChild = childDtoToChildEntity(childDto);
                newChild.setMyParent(existingParent);
                updatedChildren.add(newChild);
            }
        }

        // 可选逻辑：如果需要移除DTO中不存在的子实体，就注释掉下面这行
        // 如果不需要删除，把剩下的现有子实体加回列表
        updatedChildren.addAll(existingChildMap.values());

        // 更新父实体的子实体列表
        existingParent.setChildren(updatedChildren);
    }
}

2. 在业务层使用Mapper #

比如在Service里注入Mapper，结合数据库操作完成更新：

import org.springframework.stereotype.Service;

@Service
public class ParentService {

    private final ParentRepository parentRepository;
    private final ParentChildMapper parentChildMapper;

    // 构造注入（推荐方式）
    public ParentService(ParentRepository parentRepository, ParentChildMapper parentChildMapper) {
        this.parentRepository = parentRepository;
        this.parentChildMapper = parentChildMapper;
    }

    public ParentEntity updateParent(Long parentId, ParentDTO parentDTO) {
        // 从数据库查询现有父实体
        ParentEntity existingParent = parentRepository.findById(parentId)
                .orElseThrow(() -> new RuntimeException("未找到ID为" + parentId + "的父实体"));

        // 用Mapper执行更新逻辑
        parentChildMapper.updateParentEntityFromDto(parentDTO, existingParent);

        // 保存更新后的实体到数据库
        return parentRepository.save(existingParent);
    }
}

• 双向关联维护：新增子实体时手动设置myParent，确保JPA等ORM框架能正确识别关联关系，避免持久化异常。
• 非映射字段保护：通过@Mapping(target = "...", ignore = true)明确忽略子实体的notMappedField1和notMappedField2，保证这些字段不会被DTO的值覆盖。
• 子实体删除控制：代码里的updatedChildren.addAll(existingChildMap.values())是可选的——如果业务要求DTO里没有的子实体要被移除，就删掉这行，同时可以添加解除关联的逻辑（比如existingChildMap.values().forEach(child -> child.setMyParent(null))）。
• MapStruct版本：建议使用1.5.x及以上版本，确保@AfterMapping、@MappingTarget等注解的功能正常。

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