EF Core 7保存一对多关联实体出现重复键错误，求最佳实践

问题场景 #

我使用EF Core 7，保存一对多关系的实体时遇到错误。两个模型定义如下：

public class BetriebDto : EntityBase
{    
    // ...

    public IList<MeldesatzDto>? Meldesaetze { get; set; }
}

public class MeldesatzDto : EntityBase
{
    public required BetriebDto Betrieb { get; set; }

    // ....
}

注：两个模型均继承自EntityBase，基类包含Guid类型的Id属性。

业务逻辑是通过Kafka事件触发，保存一个Betrieb和一个Meldesatz。当前保存代码：

betriebEntity.Id = Guid.NewGuid();
await _DbContext.AddAsync(betriebEntity);
await _DbContext.SaveChangesAsync();

meldesatzEntity.Id = Guid.NewGuid();
meldesatzEntity.Betrieb = betriebEntity;        
await _DbContext.AddAsync(meldesatzEntity);
await _DbContext.SaveChangesAsync();

执行最后一次SaveChangesAsync时抛出错误：

System.ArgumentException: An item with the same key has already been added. Key: d802d14d-c748-41e2-a7ec-c8d476a719a6

这个Guid属于betriebEntity，推测EF在保存Meldesatz时尝试重复保存Betrieb。

最佳实践方案 #

方案1：关联实体后一次性保存 #

不需要分两次调用SaveChangesAsync，直接建立实体间的关联后一次性提交，EF会自动处理外键关系：

// 初始化主实体
betriebEntity.Id = Guid.NewGuid();
// 初始化子实体并关联
meldesatzEntity.Id = Guid.NewGuid();
meldesatzEntity.Betrieb = betriebEntity;
// 可选：将子实体加入主实体的集合，保持双向关联一致性
betriebEntity.Meldesaetze ??= new List<MeldesatzDto>();
betriebEntity.Meldesaetze.Add(meldesatzEntity);

// 添加主实体（EF会自动追踪关联的子实体）
await _DbContext.AddAsync(betriebEntity);
// 一次性保存所有变更
await _DbContext.SaveChangesAsync();

EF会自动生成正确的插入顺序：先插入Betrieb，再插入Meldesatz并设置对应的外键，彻底避免重复追踪实体的问题。

方案2：显式添加外键属性（推荐） #

在子实体中添加对应的外键属性，让模型关系更清晰，同时避免导航属性带来的追踪冲突：

public class MeldesatzDto : EntityBase
{
    public required BetriebDto Betrieb { get; set; }
    // 添加外键属性，与导航属性关联
    public Guid BetriebId { get; set; }

    // ....
}

保存时直接设置外键即可，无需依赖导航属性：

betriebEntity.Id = Guid.NewGuid();
await _DbContext.AddAsync(betriebEntity);
await _DbContext.SaveChangesAsync();

meldesatzEntity.Id = Guid.NewGuid();
// 直接设置外键，EF会自动关联已存在的Betrieb实体
meldesatzEntity.BetriebId = betriebEntity.Id;
await _DbContext.AddAsync(meldesatzEntity);
await _DbContext.SaveChangesAsync();

这种方式逻辑更直观，也能减少实体追踪的潜在问题。

方案3：手动修正实体追踪状态（备选） #

如果必须分两次保存，需显式告知EF主实体已存在于数据库，避免重复添加：

betriebEntity.Id = Guid.NewGuid();
await _DbContext.AddAsync(betriebEntity);
await _DbContext.SaveChangesAsync();

meldesatzEntity.Id = Guid.NewGuid();
meldesatzEntity.Betrieb = betriebEntity;
// 将主实体的状态设置为Unchanged，标记为已存在数据库
_DbContext.Entry(betriebEntity).State = EntityState.Unchanged;
await _DbContext.AddAsync(meldesatzEntity);
await _DbContext.SaveChangesAsync();

此方案仅作为特殊场景的备选，优先推荐方案1或2。

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