重复更新导致Entity Framework Core实体跟踪错误

看起来你遇到的是EF Core上下文跟踪导致的经典问题——第一次更新后，目标实体已经被当前DbContext实例跟踪了，当你后续再尝试更新同一个主键的实体（不管是复用实例还是传新实例），上下文里就会存在两个拥有相同主键的实体实例，直接触发System.InvalidOperationException。

给你几个针对性的解决方案，按推荐程度排序：

1. 每次处理消息时使用全新的DbContext实例 #

控制台应用是长运行程序，如果你复用同一个DbContext，很容易积累大量被跟踪的实体，不仅会触发这个异常，还会导致内存占用上升。最佳实践是在每次处理MQTT消息的逻辑里，用using块创建新的上下文：

// 处理MQTT消息的方法内部
public void HandleMqttMessage(YourEntity receivedEntity)
{
    using (var dbContext = new YourDbContext())
    {
        // 先查询数据库中已存在的实体
        var existingEntity = dbContext.YourEntities.FirstOrDefault(e => e.Id == receivedEntity.Id);
        
        if (existingEntity != null)
        {
            // 把接收到的属性值复制到已跟踪的实体上
            dbContext.Entry(existingEntity).CurrentValues.SetValues(receivedEntity);
        }
        else
        {
            // 实体不存在就新增
            dbContext.YourEntities.Add(receivedEntity);
        }
        
        dbContext.SaveChanges();
    }
}

这种方式从根源上避免了跟踪冲突，因为每次处理完消息，上下文就会被销毁，不会残留任何跟踪的实体。

2. 复用上下文时手动处理跟踪冲突 #

如果因为某些原因必须复用DbContext（比如性能考量），那你需要先检查上下文是否已经在跟踪目标实体：

// 假设_reusableDbContext是你全局复用的上下文实例
public void HandleMqttMessage(YourEntity receivedEntity)
{
    // 检查本地缓存（已跟踪的实体）中是否存在该主键的实体
    var trackedEntity = _reusableDbContext.YourEntities.Local.FirstOrDefault(e => e.Id == receivedEntity.Id);
    
    if (trackedEntity != null)
    {
        // 直接更新已跟踪实体的属性
        _reusableDbContext.Entry(trackedEntity).CurrentValues.SetValues(receivedEntity);
    }
    else
    {
        // 没有被跟踪的话，使用Update方法标记为修改状态
        _reusableDbContext.YourEntities.Update(receivedEntity);
    }
    
    _reusableDbContext.SaveChanges();
}

这里的关键是不要直接把新的实体实例Attach到已经有相同主键跟踪实体的上下文里，而是优先更新已有的跟踪实例。

3. 关闭实体跟踪（不推荐，但应急可用） #

如果你不需要EF的变更跟踪功能，可以在查询时关闭跟踪，或者全局配置上下文不跟踪：

// 查询时关闭跟踪
var existingEntity = dbContext.YourEntities.AsNoTracking().FirstOrDefault(e => e.Id == receivedEntity.Id);

不过这种方式会让你失去EF的自动变更检测能力，每次更新都需要手动标记实体状态，只适合临时应急，不推荐作为长期方案。

最后提醒一下：EF Core 2.x的Update方法行为是，只要上下文里有相同主键的实体被跟踪，就会抛出这个异常，所以核心原则是确保同一上下文实例中，同一主键的实体只有一个被跟踪。

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