使用EF Core更新带子实体的分离实体时产生修改与删除变更问题

问题原因 #

你遇到的问题核心在于AutoMapper默认会直接替换子实体集合，而EF Core的变更跟踪机制会将原集合中被移除的子实体标记为Deleted。具体逻辑：

1. 从数据库查询出包含子实体的父实体时，EF已经跟踪了所有子实体的状态
2. 使用AutoMapper将DTO映射到父实体时，父实体的Children集合被直接替换为DTO中的集合
3. EF检测到原有的子实体不在新集合中，会将这些子实体标记为Deleted；同时如果DTO中的子实体修改了原有子实体的属性，又会标记这些子实体为Modified，最终执行时出现先更新后删除的矛盾操作
4. 手动设置实体状态为Modified无法解决集合变更的问题，因为集合的增减是独立于实体属性修改的跟踪逻辑

解决方案 #

方案1：配置AutoMapper实现集合增量更新 #

修改AutoMapper的映射配置，让它基于子实体ID匹配来更新现有子实体、新增不存在的子实体，而不是直接替换集合。

示例配置（AutoMapper 9+）

// 父实体与DTO的映射
CreateMap<ParentDto, Parent>()
    .ForMember(dest => dest.Children, opt => 
    {
        opt.MapFrom((src, dest) => src.Children);
        // 使用目标集合的现有实例，避免替换
        opt.UseDestinationValue();
        // 配置子实体的匹配规则：按ID匹配更新
        opt.ResolveUsing((src, dest, destMember, context) =>
        {
            foreach (var childDto in src.Children)
            {
                var existingChild = destMember.FirstOrDefault(c => c.Id == childDto.Id);
                if (existingChild != null)
                {
                    // 更新现有子实体的属性
                    context.Mapper.Map(childDto, existingChild);
                }
                else
                {
                    // 新增子实体到目标集合
                    destMember.Add(context.Mapper.Map<Child>(childDto));
                }
            }
            // 删除不在DTO中的子实体
            var childrenToRemove = destMember.Where(c => !src.Children.Any(d => d.Id == c.Id)).ToList();
            foreach (var child in childrenToRemove)
            {
                destMember.Remove(child);
            }
            return destMember;
        });
    })
    .ReverseMap();

// 子实体与DTO的基础映射
CreateMap<ChildDto, Child>();

方案2：手动处理子实体的增删改 #

不依赖AutoMapper自动处理集合，手动对比数据库查询到的子实体与DTO中的子实体，分别处理更新、新增、删除操作：

// 1. 从数据库查询带跟踪的父实体
var dbModel = Repository
    .GetQueryable()
    .Include(m => m.Children)
    .FirstOrDefault(m => m.Id == dtoModel.Id);

// 2. 处理子实体：更新现有、新增缺失、移除多余
// 更新现有子实体
foreach (var childDto in dtoModel.Children)
{
    var existingChild = dbModel.Children.FirstOrDefault(c => c.Id == childDto.Id);
    if (existingChild != null)
    {
        Mapper.Map(childDto, existingChild);
    }
    else
    {
        var newChild = Mapper.Map<Child>(childDto);
        dbModel.Children.Add(newChild);
    }
}

// 删除不在DTO中的子实体
var childrenToRemove = dbModel.Children
    .Where(c => !dtoModel.Children.Any(d => d.Id == c.Id))
    .ToList();
foreach (var child in childrenToRemove)
{
    dbModel.Children.Remove(child);
}

// 3. 更新父实体属性
Mapper.Map(dtoModel, dbModel);

// 4. 保存变更（无需额外Attach/Update，因为dbModel已被EF跟踪）
await _dbContext.SaveChangesAsync();

方案3：简化UpdateAsync方法 #

由于你是从数据库查询出的dbModel，EF已经在跟踪它的状态，不需要调用Attach和Update方法（这两个方法会强制重置实体状态，反而干扰原有跟踪逻辑）。修改你的更新方法：

public override async Task<TEntity> UpdateAsync(TEntity entity, CancellationToken cancellationToken = default)
{
    // 实体已被EF跟踪，直接保存变更即可
    await _dbContext.SaveChangesAsync(cancellationToken);
    return entity;
}

这个方法需要配合方案1或方案2一起使用，才能正确处理集合变更。

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