EF Core触发实体已被跟踪异常 新增UserMetaData时程序崩溃

• ASP.NET Core 默认注册的 DbContext 为 Scoped 生命周期，同一个HTTP请求内所有操作共用同一个DbContext实例。
• 前置方法RedirectToConsentForm已通过查询语句将UserId对应的UserMetaData实体加载到DbContext的跟踪缓存中。
• 后续ConsentForm方法中，手动新建了一个与已跟踪实体同主键UserId的UserMetaData实例，直接调用Add时，DbContext检测到主键重复的已跟踪实体，抛出冲突异常。
• 隐含逻辑错误：你查询出的userMetaInfo已经是数据库中存在的记录，后续执行Add的行为本质是要更新这条记录，而非新增。

方案1：复用已跟踪的实体实例做修改（推荐） #

直接修改已查询到的、被DbContext自动跟踪的实体属性，无需新建实例，保存时DbContext会自动生成Update语句：

public IActionResult ConsentForm(string holder)
{
    var id = _httpContextAccessor.HttpContext.Session.GetString("UserId");
    var userId = new Guid(id);
    var userMetaInfo = _elearnContext.UserMetaData.FirstOrDefault(u => u.UserId == userId);

    // 补充空值校验，避免实体不存在时报错
    if (userMetaInfo == null)
    {
        // 可根据业务需求处理不存在的场景：比如新增记录或返回错误
        return NotFound();
    }

    // 直接修改现有属性
    userMetaInfo.Location = "";
    userMetaInfo.CanChangePassword = true;
    // Consent属性如果无需变更可不用赋值

    _elearnContext.SaveChanges();
    return RedirectToAction("LogOn", "Account");
}

方案2：区分「存在更新、不存在新增」的业务逻辑 #

如果业务需要在实体不存在时新增、存在时更新，可先做空判断再执行对应操作：

public IActionResult ConsentForm(string holder)
{
    var id = _httpContextAccessor.HttpContext.Session.GetString("UserId");
    var userId = new Guid(id);
    var userMetaInfo = _elearnContext.UserMetaData.FirstOrDefault(u => u.UserId == userId);

    if (userMetaInfo == null)
    {
        // 实体不存在，执行新增逻辑
        UserMetaData newMetaData = new UserMetaData
        {
            UserId = userId,
            Consent = false, // 按业务设置默认值
            Location = "",
            CanChangePassword = true
        };
        _elearnContext.UserMetaData.Add(newMetaData);
    }
    else
    {
        // 实体已存在，执行更新逻辑
        userMetaInfo.Location = "";
        userMetaInfo.CanChangePassword = true;
    }

    _elearnContext.SaveChanges();
    return RedirectToAction("LogOn", "Account");
}

方案3：无跟踪查询前置方法的实体 #

如果前置方法仅做判断、不需要修改查询结果，可在查询时添加AsNoTracking()，避免实体被加入跟踪缓存：

public IActionResult RedirectToConsentForm(string controllerName, string actionName)
{
    var Id = _httpContextAccessor.HttpContext.Session.GetString("UserId");
    var UserId = new Guid(Id);
    // 添加AsNoTracking()，查询结果不会被DbContext跟踪
    var UserMetaInfo = _elearnContext.UserMetaData.AsNoTracking().FirstOrDefault(u => u.UserId == UserId);

    if (UserMetaInfo.Consent == true)
    {
        return RedirectToAction("ConsentForm", "Account");
    }
    else
    {
        return RedirectToAction(controllerName, actionName);
    }
}

• 禁止手动创建与已跟踪实体同主键的实例再调用Add，这是EF Core跟踪冲突的最高发场景。
• 跨方法传递实体时优先传递主键值，不要直接传递被跟踪的实体实例，避免上下文跟踪混乱。
• 调试时可通过DbContextOptionsBuilder.EnableSensitiveDataLogging()输出具体冲突的主键值，快速定位问题。

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