C#使用Entity Framework操作数据库出现同键跟踪报错的最佳实践

该报错由EF Core的变更跟踪机制触发：你通过查询得到的exists实例已经被当前上下文（Context）跟踪持有，此时尝试对另一个同主键的外部实例x执行Update操作，上下文就会出现两个主键相同的被跟踪实例，进而触发冲突。

1. 直接更新已跟踪实例（小批量数据首选，最稳妥） #

无需调用Update方法，将外部实例的属性赋值给已被跟踪的exists实例即可，上下文会自动检测属性变更生成对应更新语句：

foreach (Category x in CustomeClass)
{
    Category exists = Context.SSActivewear_Category
                            .Where(b => b.CategoryID == x.CategoryID)
                            .FirstOrDefault();

    if (exists == null)
    {
        Context.Add(x);
    }
    else
    {
        // 手动映射属性，也可通过AutoMapper等工具批量映射
        exists.CategoryName = x.CategoryName;
        exists.OtherField = x.OtherField;
        // 无需手动调用Update，跟踪器会自动识别变更
    }
}
// 统一提交事务，不要在循环内每次调用SaveChanges
Context.SaveChanges();

2. 查询时关闭跟踪（全量覆盖更新场景适用） #

如果不需要对比新旧数据、直接全量覆盖现有条目，可以在查询时关闭跟踪，避免多余实例被上下文持有，同时可用Any替代FirstOrDefault减少不必要的实体查询开销：

foreach (Category x in CustomeClass)
{
    bool isExist = Context.SSActivewear_Category
                        .AsNoTracking() // 关闭当前查询的跟踪逻辑
                        .Any(b => b.CategoryID == x.CategoryID);

    if (!isExist)
        Context.Add(x);
    else
        Context.Update(x);
 }
Context.SaveChanges();

3. 批量Upsert（大数据量同步场景首选） #

如果定时同步的数据量较大，逐条操作性能低，可直接使用对应数据库的原生Upsert语法（比如SQL Server的MERGE、MySQL的INSERT ... ON DUPLICATE KEY UPDATE），绕过EF Core的变更跟踪逻辑，性能提升十分明显。

• 定时同步任务建议按批次处理数据，每处理数百条就销毁重建上下文，避免上下文跟踪的实例过多导致内存溢出
• 非必要不要手动修改实体的Entry状态，容易引发不可预期的跟踪冲突

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