Entity Framework插入数据需手动设置State.Unchanged的疑问

嗨，Claus！我完全理解你遇到的这个困扰——EF Core在处理关联已存在实体时的状态跟踪问题确实很容易让人踩坑，先给你拆解下背后的原因，再分享几个更优雅的解决办法，不用每次都手动去修改实体状态~

为什么会出现重复插入的报错？ #

当你创建新的Case对象并关联author和author.Org时，如果这些实体没有被当前的DbContext实例跟踪（比如是从另一个上下文获取的、或者是手动构造的对象），EF Core会默认把它们判定为全新的实体，在调用SaveChangesAsync时就会尝试向数据库插入这些“重复”的数据，自然就触发了唯一约束的报错。你手动设置EntityState.Unchanged的方式是有效的——相当于明确告诉EF：“这些实体已经在数据库里了，别再插入新的”，但这并不是最省心的处理方式。

更优的解决方案，不用手动改状态 #

这里有几个更高效的处理思路，你可以根据场景选择：

• 方案1：让DbContext自动跟踪已存在实体
  如果你是通过当前上下文加载的author和author.Org（比如用_context.Persons.Include(p => p.Org).FirstOrDefault(...)这类查询获取），那EF已经自动跟踪这些实体的状态了。这时候直接把它们关联到新的Case上，EF会正确识别它们是已存在的，不会触发重复插入。这是最推荐的方式，毕竟状态跟踪本来就是EF的核心能力，尽量让上下文自己管理状态才是最省心的。

• 方案2：用Attach方法批量标记已存在实体
  如果author和author.Org是来自外部（比如序列化后的对象、其他上下文实例），你可以用Attach方法一次性告诉EF这些实体已经存在于数据库中：

  _context.Attach(author.Org);
  _context.Attach(author);
  var c = new Case { IsDraft = true, Organization = author.Org, Author = author };
  _context.Cases.Add(c);
  await _context.SaveChangesAsync();
  

  Attach会把实体及其未被跟踪的导航属性都标记为Unchanged，比手动逐个设置状态要简洁得多，尤其是关联层级比较多的时候。

• 方案3：直接关联主键（适合仅需外键关联的场景）
  如果你不需要操作author或Org的其他属性，只是要建立关联关系，可以直接创建只包含主键的实体对象，EF会自动识别这是已存在的实体，不会尝试插入新数据：

  var c = new Case { 
      IsDraft = true, 
      OrganizationId = author.Org.Id, // 假设Organization实体的主键为Id
      AuthorId = author.Id // 假设Person实体的主键为Id
  };
  _context.Cases.Add(c);
  await _context.SaveChangesAsync();
  

  这种方式不需要加载整个实体，也不需要处理状态，性能更好，适合只需要建立外键关联的简单场景。

总结 #

你之前手动设置状态的方式是有效的，但并不是必须的——只要让EF正确识别这些实体是已存在的，就能避免重复插入的问题。优先选择方案1（让上下文跟踪实体），如果场景不允许，再考虑方案2或3，比手动逐个修改状态更高效也更易维护。

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