如何在Entity Framework Core中更新包含依赖对象的记录？

问题背景 #

我在Blazor项目中学习EF Core 8，搭建简单博客时遇到了多对多关联更新的问题。实体定义如下：

Article实体 #

[Table("Articles")]
public class Article : Table
{
    [JsonPropertyName("body")]
    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
    public string? Body { get; set; }

    public ICollection<Category>? Categories { get; set; }
    public ICollection<Tag>? Tags { get; set; }
}

Category实体（Tag结构类似） #

[Table("tbl_Categories")]
public class Category : Table
{
    public string? Name { get; set; }
    public ICollection<Article>? Articles { get; set; }
}

EF自动生成了Articles、tbl_Categories表，以及自动创建的多对多关联表ArticleCategory（代码中无对应实体）。

遇到的问题 #

1. 主键冲突错误：更新Article时，如果传入已关联过的Category，会触发主键冲突：

An error occurred while saving the entity changes. See the inner exception for details.
---> Microsoft.Data.SqlClient.SqlException (0x80131904): Violation of PRIMARY KEY constraint 'PK_ArticleCategory'. Cannot insert duplicate key in object 'ArticleCategory'. The duplicate key value is (8, 15).

2. 实体跟踪冲突错误：为解决上述问题，我写了清除关联的方法：

public void DeleteCategoriesByArticle(long id)
{
    var article = localDb?.Articles?
                          .Include(a => a.Categories)?
                          .Where(a => a.ID == id)
                          .FirstOrDefault();
    if (article != null)
    {
        bool hasChanges = false;

        if (article.Categories != null && article.Categories.Count() > 0)
        {
            article.Categories?.Clear();
            hasChanges = true;
        }

        if (hasChanges)
            localDb?.SaveChanges();
    }
}

但调用更新方法时又出现跟踪冲突：

The instance of entity type 'Article' 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.

3. 给查询加上AsNoTracking()后，主键冲突消失，但不知道该如何正确更新Article记录。我的通用更新方法如下：

public void Update(T entity)
{
    _log.LogDebug($"[{nameof(T)}] Update an entity");
        
    if (entity == null)
        throw new ArgumentNullException(nameof(entity));

    if (entity.ModifiedAt == DateTime.MinValue)
        entity.ModifiedAt = DateTime.UtcNow;

    _db.Entry(entity).State = EntityState.Modified;
    _db.SaveChanges();
}

解决方案 #

1. 解决实体跟踪冲突 #

出现跟踪冲突的核心原因是：你先通过localDb查询并跟踪了Article实例，之后又用另一个DbContext（_db）操作同一个ID的实体。两种解决思路：

• 复用同一个DbContext实例：确保查询和更新操作在同一个DbContext生命周期内完成（比如在同一个请求或服务实例中）。
• 手动解除实体跟踪：如果必须用不同DbContext，查询后执行localDb.Entry(article).State = EntityState.Detached;，解除跟踪后再执行更新。

2. 正确更新多对多关联 #

不需要单独写清除关联的方法，直接在更新时处理关联集合即可，EF会自动同步关联表：

public void UpdateArticle(Article updatedArticle)
{
    // 从数据库获取带关联数据的Article（保持跟踪状态）
    var existingArticle = _db.Articles
        .Include(a => a.Categories)
        .Include(a => a.Tags)
        .FirstOrDefault(a => a.ID == updatedArticle.ID);
    
    if (existingArticle == null)
        throw new KeyNotFoundException("Article not found");

    // 更新Article基本属性
    _db.Entry(existingArticle).CurrentValues.SetValues(updatedArticle);

    // 处理Categories关联：清空现有关联，再添加新的（注意Attach已存在的Category）
    existingArticle.Categories.Clear();
    foreach (var category in updatedArticle.Categories ?? Enumerable.Empty<Category>())
    {
        // Attach已存在的Category，避免EF误判为新实体插入
        _db.Categories.Attach(category);
        existingArticle.Categories.Add(category);
    }

    // 同理处理Tags关联
    existingArticle.Tags.Clear();
    foreach (var tag in updatedArticle.Tags ?? Enumerable.Empty<Tag>())
    {
        _db.Tags.Attach(tag);
        existingArticle.Tags.Add(tag);
    }

    existingArticle.ModifiedAt = DateTime.UtcNow;
    _db.SaveChanges();
}

3. 优化通用更新方法 #

如果要保留通用Update方法，可以扩展它支持关联实体处理：

public void Update(T entity, Action<T, DbContext>? handleRelations = null)
{
    _log.LogDebug($"[{nameof(T)}] Update an entity");
        
    if (entity == null)
        throw new ArgumentNullException(nameof(entity));

    if (entity.ModifiedAt == DateTime.MinValue)
        entity.ModifiedAt = DateTime.UtcNow;

    var entry = _db.Entry(entity);
    if (entry.State == EntityState.Detached)
    {
        _db.Set<T>().Attach(entity);
        entry.State = EntityState.Modified;
    }

    // 传入关联处理逻辑
    handleRelations?.Invoke(entity, _db);

    _db.SaveChanges();
}

调用时处理关联：

Update(article, (art, db) =>
{
    // Attach所有关联的Category和Tag，避免插入重复
    foreach (var cat in art.Categories ?? Enumerable.Empty<Category>())
        db.Categories.Attach(cat);
    foreach (var tag in art.Tags ?? Enumerable.Empty<Tag>())
        db.Tags.Attach(tag);
});

关键注意点 #

• 多对多关联中，添加已存在的关联实体时必须先Attach到DbContext，否则EF会尝试插入新实体导致主键冲突。
• 避免在不同DbContext实例中操作同一个实体，否则必然触发跟踪冲突。
• 直接设置EntityState.Modified无法自动处理多对多关联，必须手动操作关联集合的增删，EF才会同步更新关联表。

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