Entity Framework添加同数据子对象时跟踪冲突的解决方法

EF 不存在任何可以自动识别同主键重复实体、自动合并复用跟踪实例的配置项，你遇到的跟踪异常是EF变更追踪器的默认设计行为导致的，和实体关系配置是否完善没有直接关系。
EF变更追踪器有明确的硬性规则：同一个上下文实例中，任意配置了主键的实体类型，同一个主键值永远只能对应一个被跟踪的实体实例。追踪器不会自动对比不同实例的属性值做合并复用，只要检测到同主键的第二个实例尝试进入跟踪状态，就会直接抛出你看到的异常——不管你对Parent和Child的多对多关系配置得多么完整，只要传入的对象图里存在同Id的不同Child实例，异常就会触发。

可选处理方案 #

1. 数据源入口处统一去重（最优方案，你已经验证过可行性） #

这是逻辑最干净、性能最好的处理方式：在Web API返回的数据反序列化完成、传入EF上下文之前，全局遍历所有实体，把同主键的重复实例替换为同一个实例即可。
参考处理代码：

var childMap = new Dictionary<int, Child>();
foreach (var parent in parents)
{
    // ToList()避免遍历集合时修改集合报错
    foreach (var child in parent.Children.ToList())
    {
        if (!childMap.ContainsKey(child.Id))
        {
            childMap[child.Id] = child;
        }
        else
        {
            // 替换重复引用为唯一实例
            parent.Children.Remove(child);
            parent.Children.Add(childMap[child.Id]);
        }
    }
}

处理完成后整个对象图完全符合EF的跟踪规则，你原来的保存逻辑不需要做任何修改就能正常运行。

2. 保存逻辑中手动处理子实体跟踪 #

如果不方便在数据源层面做去重，就不要让EF在保存Parent时自动递归附加整个Children导航属性，单独处理子实体的跟踪状态：

foreach (var parent in parents)
{
    var parentModel = await context.Parents.FirstOrDefaultAsync(p => p.Id == parent.Id);
    // 先把导航属性的子实体暂存，清空集合避免EF自动附加
    var incomingChildren = parent.Children.ToList();
    parent.Children.Clear();

    if (parentModel == null)
    {
        await context.Parents.AddAsync(parent);
    }
    else
    {
        context.Entry(parentModel).CurrentValues.SetValues(parent);
    }

    foreach (var child in incomingChildren)
    {
        // 优先查找上下文已经跟踪的同Id实例
        var trackedChild = context.ChangeTracker.Entries<Child>()
            .FirstOrDefault(e => e.Entity.Id == child.Id)?.Entity;
        if (trackedChild == null)
        {
            trackedChild = await context.Children.FindAsync(child.Id);
        }

        if (trackedChild == null)
        {
            // 没有跟踪记录就附加当前传入的实例
            context.Add(child);
            parent.Children.Add(child);
        }
        else
        {
            // 已有跟踪实例就更新属性值，关联到已跟踪的实例上
            context.Entry(trackedChild).CurrentValues.SetValues(child);
            parent.Children.Add(trackedChild);
        }
    }
}
await context.SaveChangesAsync();

3. 不推荐的临时方案 #

如果是一次性数据导入场景，可以临时为这个操作创建全新的上下文实例，全程使用无跟踪查询，但这种方式很容易导致关联关系处理出错、重复插入数据，不适合常规业务场景使用。

误区澄清 #

不需要在实体关系配置上浪费时间排查问题。多对多等关系配置的作用是告诉EF实体间的关联规则、外键映射、连接表结构，不会改变变更追踪器的底层运行逻辑，无论怎么配置，都不会让EF自动合并同主键的不同实例。

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