移除标签后重新添加同标签报EF实体附加错误的原因排查

核心冲突：DbContext实体跟踪机制的主键重复 #

当你用Include(x=>x.Tags)查询User时，所有关联的Tag实体都会被当前DbContext实例跟踪缓存。后续执行user.Tags.Remove(tag)并调用SaveChangesAsync()，这一步只删除了UserTag中间表中User和Tag的关联记录，既没有删除Tag实体本身，也没有把原来的Tag实体从DbContext的跟踪缓存里清掉。

当你创建一个tag_id和被移除标签相同的新Tag实例，再把它添加到user.Tags时，EF Core会尝试把这个新实例附加到DbContext。但此时上下文的跟踪缓存里已经躺着一个同tag_id的Tag实体（就是之前查询出来、后来被移除关联的那个），EF Core不允许同一个上下文里存在两个主键相同的实体实例，于是就抛出了那个错误：

When attaching existing entities, ensure that only one entity instance with a given key value is attached

步骤拆解 #

• 查询阶段：Include(x=>x.Tags)加载了User和关联的Tag（比如tag_id=1的实例），这个Tag被DbContext标记为Unchanged状态，存在跟踪缓存中。
• 移除关联阶段：user.Tags.Remove(tag)只是断开了User和Tag的多对多关联，SaveChangesAsync()仅操作UserTag表删除关联记录，原Tag实体始终在DbContext的跟踪范围内。
• 添加新Tag阶段：新创建的Tag实例（同tag_id）要被附加到上下文时，发现缓存里已有同主键的实体，直接触发主键冲突报错。

验证方法 #

你可以在添加新Tag前加一段代码验证跟踪状态：

// 在user.Tags.Add(new_tag)前执行
var trackedTag = db.ChangeTracker.Entries<Tag>().FirstOrDefault(t => t.Entity.tag_id == 1);
// 此时trackedTag不为null，说明原Tag还在被DbContext跟踪

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