Entity Framework实体跟踪冲突求助：相同键值实体无法被跟踪

运行代码时出现如下错误：

The instance of entity type 'UserWord' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked

原因是第一次查询返回的UserWord实体被上下文跟踪，第二次用Where查询同一实体时，EF会尝试再次跟踪该实体，导致键值冲突。以下是几种仅修改函数内部代码的解决方案：

方案一：查询时禁用跟踪（AsNoTracking） #

查询时通过AsNoTracking()让实体不被上下文跟踪，避免重复跟踪冲突；保存时处理本地跟踪实体的更新逻辑：

private Task<UserWord> getUserWord() 
{
    return _db.UserWords.Where(uw => uw.UserId == 111).AsNoTracking().FirstOrDefaultAsync();
}

private async Task<int> Save(UserWord uw) 
{
    var trackedEntity = _db.UserWords.Local.FirstOrDefault(e => e.Id == uw.Id);
    if (trackedEntity != null)
    {
        _db.Entry(trackedEntity).CurrentValues.SetValues(uw);
    }
    else
    {
        _db.UserWords.Attach(uw);
        _db.Entry(uw).State = EntityState.Modified;
    }
    return await _db.SaveChangesAsync();
}

方案二：优先使用本地跟踪实体 #

查询前先检查上下文本地缓存中是否存在目标实体，存在则直接返回，避免重复查询数据库和跟踪冲突：

private Task<UserWord> getUserWord() 
{
    var localUw = _db.UserWords.Local.FirstOrDefault(uw => uw.UserId == 111);
    if (localUw != null)
    {
        return Task.FromResult(localUw);
    }
    return _db.UserWords.Where(uw => uw.UserId == 111).FirstOrDefaultAsync();
}

// Save方法保持原逻辑即可
private Task<int> Save(UserWord uw) 
{
    _db.UserWords.Update(uw);
    return _db.SaveChangesAsync();
}

方案三：保存后分离实体 #

每次保存完成后，将实体从上下文跟踪中分离，下次查询时不会触发冲突：

private async Task<int> Save(UserWord uw) 
{
    _db.UserWords.Update(uw);
    var result = await _db.SaveChangesAsync();
    _db.Entry(uw).State = EntityState.Detached;
    return result;
}

// getUserWord方法保持原逻辑即可
private Task<UserWord> getUserWord() 
{
    return _db.UserWords.Where(uw => uw.UserId == 111).FirstOrDefaultAsync();
}

方案适用场景 #

• 方案一：适合频繁查询同一实体且需要修改的场景，AsNoTracking可提升查询性能
• 方案二：适合希望复用上下文缓存实体、减少数据库查询的场景
• 方案三：适合每次操作后不再需要跟踪该实体的简单场景

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