EF Core中如何深度克隆/复制实体及其关联对象？

嗨，我之前也碰到过一模一样的问题！EF Core默认会把你从上下文里查出来的实体标记为Unchanged状态，直接添加的话它会认为你要更新现有实体，而不是插入新的——这就是为啥ID冲突的原因。哪怕你手动改了ID，关联的子对象可能还带着原来的外键或者被上下文追踪着，照样会出问题。

下面是我亲测有效的解决方案，一步步来：

1. 先把要克隆的实体从上下文追踪中分离出来 #

你查出来的School对象是被EF上下文追踪的，第一步必须切断追踪，这样EF才不会把它当成现有实体。有两种简单的方式：

// 方式1：查询时就禁用追踪（最省心）
var originalSchool = _context.Schools
    .Include(s => s.Students) // 记得包含所有需要克隆的子对象/关联对象
    .Include(s => s.Teachers)
    .AsNoTracking()
    .FirstOrDefault(s => s.Id == schoolId);

// 方式2：查询后手动分离实体（需要逐个处理子对象，不如方式1方便）
var originalSchool = _context.Schools
    .Include(s => s.Students)
    .Include(s => s.Teachers)
    .FirstOrDefault(s => s.Id == schoolId);
_context.Entry(originalSchool).State = EntityState.Detached;
// 子对象也要手动分离：
foreach(var student in originalSchool.Students)
{
    _context.Entry(student).State = EntityState.Detached;
}

2. 重置所有实体的ID和外键（包括子对象） #

接下来要把克隆对象的ID、所有子对象的ID，以及关联的外键都重置——如果你的ID是自增类型（比如int），直接设为默认值（0或者null）就行，EF插入时会自动生成新ID；如果是Guid类型，就设为Guid.Empty。

手动克隆适合结构简单的实体： #

var clonedSchool = new School
{
    Name = originalSchool.Name,
    Address = originalSchool.Address,
    Id = 0, // 重置School的ID
    
    // 处理学生集合
    Students = originalSchool.Students.Select(s => new Student
    {
        Name = s.Name,
        Age = s.Age,
        Id = 0, // 重置学生ID
        SchoolId = 0 // 外键先设为0，插入时EF会自动关联新的SchoolID
    }).ToList(),
    
    // 处理教师集合
    Teachers = originalSchool.Teachers.Select(t => new Teacher
    {
        Name = t.Name,
        Subject = t.Subject,
        Id = 0,
        SchoolId = 0
    }).ToList()
};

序列化反序列化适合层级深的复杂实体： #

如果子对象层级多、关联复杂，手动赋值太麻烦，可以用序列化反序列化快速克隆，再批量重置ID：

// 用Newtonsoft.Json序列化再反序列化（需要先安装包）
var json = JsonConvert.SerializeObject(originalSchool);
var clonedSchool = JsonConvert.DeserializeObject<School>(json);

// 递归重置所有实体的ID和外键
ResetAllEntityIds(clonedSchool);

// 递归处理方法
void ResetAllEntityIds(object entity)
{
    if (entity == null) return;
    
    var entityType = entity.GetType();
    // 重置ID属性（假设所有实体的ID属性都叫Id）
    var idProp = entityType.GetProperty("Id");
    if (idProp != null)
    {
        if (idProp.PropertyType == typeof(int)) idProp.SetValue(entity, 0);
        else if (idProp.PropertyType == typeof(Guid)) idProp.SetValue(entity, Guid.Empty);
    }
    
    // 重置外键（比如SchoolId、TeacherId这类）
    var foreignKeyProp = entityType.GetProperty($"{entityType.Name}Id");
    if (foreignKeyProp != null)
    {
        if (foreignKeyProp.PropertyType == typeof(int)) foreignKeyProp.SetValue(entity, 0);
        else if (foreignKeyProp.PropertyType == typeof(Guid)) foreignKeyProp.SetValue(entity, Guid.Empty);
    }
    
    // 处理集合类型的子对象
    foreach (var prop in entityType.GetProperties())
    {
        if (prop.PropertyType.IsGenericType && prop.PropertyType.GetGenericTypeDefinition() == typeof(List<>))
        {
            var collection = prop.GetValue(entity) as IEnumerable<object>;
            if (collection != null)
            {
                foreach (var item in collection)
                {
                    ResetAllEntityIds(item);
                }
            }
        }
        // 处理单个子对象（比如一对一关联）
        else if (prop.PropertyType.Namespace == entityType.Namespace)
        {
            var childEntity = prop.GetValue(entity);
            ResetAllEntityIds(childEntity);
        }
    }
}

3. 将克隆对象添加到上下文并保存 #

现在克隆对象和所有子对象都脱离了原上下文的追踪，ID也都重置好了，直接添加保存就行：

_context.Schools.Add(clonedSchool);
await _context.SaveChangesAsync();

几个关键注意点 #

• 一定要用AsNoTracking()查询原实体，避免后续出现状态冲突的问题。
• 如果用AutoMapper，可以配置映射规则自动忽略ID和外键，生成默认值，这样更高效：

  CreateMap<School, School>()
      .ForMember(dest => dest.Id, opt => opt.MapFrom(src => 0))
      .ForMember(dest => dest.Students, opt => opt.MapFrom(src => src.Students.Select(s => Mapper.Map<Student>(s))));
  CreateMap<Student, Student>()
      .ForMember(dest => dest.Id, opt => opt.MapFrom(src => 0))
      .ForMember(dest => dest.SchoolId, opt => opt.MapFrom(src => 0));
  

这样操作后，EF就会把整个School及其所有子对象当成全新的实体插入数据库，不会再出现ID冲突的问题啦！

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