EF Core添加包含已有子对象的新对象时引发重复键异常的通用解决方法

这种情况我之前做项目时也碰到过，简直踩坑踩得头疼！EF Core默认会把所有关联的未被追踪的实体都标记成Added状态，哪怕你只给子对象传了一个已存在的ID，它也会傻乎乎地准备把这个子对象再插一遍，直接触发重复键错误。

不想每次都先查数据库捞子对象？安排一个通用的解决方案就完事了——核心思路就是提前告诉EF Core：这些带有效ID的子对象是数据库里已经有的，别瞎插入！

原理说明 #

EF Core的变更追踪是看实体状态的：当你调用Add添加主实体时，它会递归遍历所有导航属性，把没被上下文追踪的实体都设为Added状态。所以我们要做的，就是在Add主实体之前，把那些已有有效ID的子实体“标记”为已存在的，让EF Core放弃插入它们。

通用实现方案：写一个DbContext扩展方法 #

我们可以写一个通用的扩展方法，递归处理实体的所有导航属性（不管是单个引用还是集合），只要发现子实体的ID是有效非默认值（比如Guid不是Empty、int不是0），就把它Attach到上下文——Attach之后EF Core就会把这个实体的状态设为Unchanged，认定它是数据库里已有的对象。

1. 支持所有实体（用反射兼容不同ID类型）

如果你的实体没有统一基类，用反射来获取ID属性就行，兼容性拉满：

public static void MarkExistingEntitiesAsUnchanged<T>(this DbContext context, T entity) where T : class
{
    if (entity == null)
        return;

    var entry = context.Entry(entity);
    // 已经被追踪的实体就不用处理了
    if (entry.State != EntityState.Detached)
        return;

    // 遍历所有导航属性
    foreach (var navigation in entry.Navigations)
    {
        if (navigation.IsCollection)
        {
            // 处理集合类型的导航属性（比如List<B>）
            if (navigation.CurrentValue is IEnumerable<object> collection)
            {
                foreach (var item in collection)
                {
                    context.MarkExistingEntitiesAsUnchanged(item);
                }
            }
        }
        else
        {
            // 处理单个引用类型的导航属性（比如你的B Child）
            if (navigation.CurrentValue is object childEntity)
            {
                context.MarkExistingEntitiesAsUnchanged(childEntity);
            }
        }
    }

    // 检查当前实体的ID是否有效，有效就Attach到上下文
    var idProperty = entity.GetType().GetProperty("Id");
    if (idProperty == null)
        return;

    var idValue = idProperty.GetValue(entity);
    bool hasValidId = idValue switch
    {
        Guid guid => guid != Guid.Empty,
        int intId => intId != 0,
        long longId => longId != 0,
        _ => idValue != null // 兼容其他ID类型，比如string
    };

    if (hasValidId)
    {
        context.Attach(entity);
    }
}

2. 优化版：基于统一基类（性能更好）

如果你的所有实体都继承了带ID的基类（比如BaseEntity），可以把代码改得更简洁，还能避开反射提升性能：

// 先定义统一基类
public class BaseEntity
{
    public Guid Id { get; set; }
}

// 你的实体都继承这个基类
public class A : BaseEntity
{
    public string Name { get; set; }
    public B Child { get; set; }
}

public class B : BaseEntity
{
    public string Name { get; set; }
}

// 优化后的扩展方法
public static void MarkExistingEntitiesAsUnchanged<T>(this DbContext context, T entity) where T : BaseEntity
{
    if (entity == null || entity.Id == Guid.Empty)
        return;

    var entry = context.Entry(entity);
    if (entry.State != EntityState.Detached)
        return;

    foreach (var navigation in entry.Navigations)
    {
        if (navigation.IsCollection)
        {
            if (navigation.CurrentValue is IEnumerable<BaseEntity> collection)
            {
                foreach (var item in collection)
                {
                    context.MarkExistingEntitiesAsUnchanged(item);
                }
            }
        }
        else
        {
            if (navigation.CurrentValue is BaseEntity childEntity)
            {
                context.MarkExistingEntitiesAsUnchanged(childEntity);
            }
        }
    }

    context.Attach(entity);
}

怎么用？ #

就两步，先处理再添加：

// 反序列化得到主实体
var deserializedObject = JsonSerializer.Deserialize<A>(yourJsonString);

// 先调用扩展方法标记已有实体
yourDbContext.MarkExistingEntitiesAsUnchanged(deserializedObject);

// 再添加主实体，此时EF Core不会插入已存在的子对象了
yourDbContext.Set<A>().Add(deserializedObject);
yourDbContext.SaveChanges();

注意事项 #

• 这个方法一定要在Add主实体之前调用，不然EF Core已经把状态设成Added了，再改就晚了。
• 如果子实体的ID是默认值（比如Guid.Empty、int=0），方法会跳过它，EF Core还是会正常插入新的子对象，这完全符合我们的预期。
• 如果你100%确定某个子实体一定是已存在的，也可以直接手动把它的状态设为Unchanged，但用Attach更安全——它会自动根据ID是否有效判断该设什么状态。

备注：内容来源于stack exchange，提问作者Lee