EF Core调用Update方法却执行INSERT新增数据问题排查

问题根因 #

你遇到的问题本质是EF Core的跟踪机制导致的：当传入Update方法的实体没有被当前操作的DbContext实例跟踪时，EF Core默认会将实体状态标记为Added，哪怕实体主键已经赋值，也会执行插入操作生成新行。

修复方案 #

方案1：先查询跟踪实体，再赋值更新（推荐，安全性最高）

先通过主键从当前上下文查询出被跟踪的现有实体，再把传入实体的字段值覆盖到现有实体上，EF会自动识别字段变更生成更新语句。
修改Repository层的Update方法：

public void Update(TEntity entity)
{
    // 通用获取主键值的方式，适配所有带主键的实体
    var keyProperty = context.Model.FindEntityType(typeof(TEntity))?.FindPrimaryKey()?.Properties.FirstOrDefault();
    if (keyProperty == null) throw new InvalidOperationException("实体未定义主键");
    var keyValue = keyProperty.GetGetter().GetClrValue(entity);
    
    var existingEntity = dbSet.Find(keyValue);
    if (existingEntity == null) throw new KeyNotFoundException("对应主键的数据不存在");
    
    // 批量覆盖所有字段值
    context.Entry(existingEntity).CurrentValues.SetValues(entity);
    context.SaveChanges();
}

方案2：手动标记实体状态为Modified（适合确定实体合法、无需校验数据存在的场景）

不需要额外查询数据库，直接手动指定实体为修改状态，EF会直接生成更新语句，不会执行插入。
修改Repository层的Update方法：

public void Update(TEntity entity)
{
    context.Entry(entity).State = EntityState.Modified;
    context.SaveChanges();
}

注意：该方案会生成全字段更新的SQL语句，如果仅需要修改部分字段不推荐使用，且如果主键不存在会抛出更新失败的异常。

方案3：检查DbContext生命周期配置

如果你的项目是ASP.NET Core，确认DbContext的注册生命周期是否为默认的Scoped：

//  Program.cs中的注册示例
builder.Services.AddDbContext<YourDbContext>(options => 
    options.UseSqlServer("你的连接字符串")); // 默认就是Scoped生命周期

如果注册为Transient瞬态，会导致每次请求Repository实例时拿到的是不同的上下文实例，实体自然无法被跟踪，也会触发插入问题。

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