记录一次EF实体跟踪错误

前言

在我写文章编辑接口的，出现了一个实体跟踪的错误，详情如下

System.InvalidOperationException: The instance of entity type 'Tag' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the conflicting key values.

System.InvalidOperationException：无法跟踪实体类型“Tag”的实例，因为已跟踪具有相同 {'Id'} 键值的另一个实例。附加现有实体时，请确保仅附加一个具有给定键值的实体实例。考虑使用“DbContextOptionsBuilder.EnableSensitiveDataLogging”来查看冲突的键值。

代码

这是控制器，这个是用于修改文章的一个接口

[HttpPut("{id}")] public async Task<ApiResponse<Post>> Update(string id, PostUpdateDto dto) {     var post = _postService.GetById(id);     if (post == null) return ApiResponse.NotFound($"博客 {id} 不存在");          post = _mapper.Map(dto, post);     post.LastUpdateTime = DateTime.Now;     return new ApiResponse<Post>(await _postService.InsertOrUpdateAsync(post)); } 

PostUpdateDto类如下：

public class PostUpdateDto     {         public string Id { get; set; }         /// <summary>         /// 标题         /// </summary>         public string Title { get; set; }         /// <summary>         /// 梗概         /// </summary>         public string Summary { get; set; }         /// <summary>         /// 内容（markdown格式）         /// </summary>         public string Content { get; set; }         /// <summary>         /// 分类ID         /// </summary>         public int CategoryId { get; set; }         /// <summary>         /// 标签         /// </summary>         public List<Tag> Tags { get; set; }     } 

关键在于public List<Tag> Tags { get; set; } 这里，我使用了Map去让PostUpdateDto可以映射为post文章类，然后Tags是前端传过来的标签集合，同时也是post的导航属性，控制器是没毛病的，继续往下看。

然后是InsertOrUpdateAsync方法：

传递一个post实体对象，然后对实体进行增改操作，我按照常规的写法，修改标签，肯定是要将文章之前的标签删除掉，然后重新添加，这是正常的流程。PostTags就是标签表，用于维护标签和文章的关系，删除文章标签实际就是删除PostTags表的内容。

可以看到我删除了existingTags查询出的对象，也就是删除当前文章下的标签。然后通过遍历前端传过来的tags对象新增新的书签，之后就是保存到数据库的操作了。流程是没有问题的，但是每次编辑就报Tags实体跟踪错误

public async Task<Post> InsertOrUpdateAsync(Post post)         {             using var transaction = await _myDbContext.Database.BeginTransactionAsync();              try             {                 // 是新文章的话，先保存到数据库                 if (await _myDbContext.posts.FindAsync(post.Id) == null)                 {                     post.ViewCount = 0;                     await _myDbContext.posts.AddAsync(post);                     await _myDbContext.SaveChangesAsync();                 }                  var tags = post.Tags.ToList();                 // 移除原有的标签,没写引发异常                 // post.Tags.Clear();                 var existingTags = await _myDbContext.PostTags                     .Where(pt => pt.PostId == post.Id)                     .ToListAsync();                  _myDbContext.PostTags.RemoveRange(existingTags);                 //修改                 foreach (var tagName in tags)                 {                     var postTag = new PostTag                     {                         PostId = post.Id,                         TagId = tagName.Id,                     };                      _myDbContext.PostTags.Add(postTag);                 }                  // 保存更改到数据库                 await _myDbContext.SaveChangesAsync();                  // 检查文章中的外部图片，下载并进行替换                 post.Content = await MdExternalUrlDownloadAsync(post);                  // 修改文章时，将markdown中的图片地址替换成相对路径再保存                 post.Content = MdImageLinkConvert(post, false);                  // 更新文章                 _myDbContext.posts.Attach(post);                 _myDbContext.Entry(post).State = EntityState.Modified;                 await _myDbContext.SaveChangesAsync();                  // 提交事务                 await transaction.CommitAsync();                  return post;             } 

错误在开头就说了，无法跟踪实体类型“Tag”的实例，我琢磨的很久，我明明没有查询Tag，也没有删除Tag，我删除的是PostTags表，为什么会报这个错误。而且我是没有做外键约束的。

解决

找了很久，发现了一个致命的漏点，我传递的post对象是一个导航属性的Tags的，如图：

可以看到Tags里面是有PostTags的，所以当我获取所有标签var tags = post.Tags.ToList();同时删除PostTags中的内容的时候_myDbContext.PostTags.RemoveRange(existingTags)然后通过循环 foreach (var tagName in tags) 添加了新的标签，但是我并没有将这些标签从 post.Tags 集合中移除。因此，当我保存更改到数据库时，EF Core 会认为 post.Tags 集合中的标签实例已经被跟踪，导致了异常。

简单来说就是post中的Tags要被清除才行，也就是这行代码必须要写上去

// 移除原有的标签 post.Tags.Clear(); 

结论

当对具有导航属性的数据进行增删改的时候，先看看实体中是否存在这些数据，记得先Clear再执行操作。在Clear之前可以将需要的数据保存到变量中，因为Clear之后，是无法通过实体.(点)出属性了