记录一次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之后,是无法通过实体.(点)出属性了