EF Core 3.1新增实体时为何会重复插入已存在的导航属性
问题根因解释
EF Core 3.1 出现重复插入已存在关联实体的问题,核心原因是AddAsync方法的整图状态追踪规则,和你观察到的现象完全匹配:
核心追踪逻辑
当对根实体调用AddAsync方法时,EF Core会执行两个固定动作:
- 把当前传入的根实体(这里是映射生成的
Profile对象)的实体状态标记为Added - 递归遍历这个根实体挂载的所有可达导航属性,对所有遍历到的、没有被当前DbContext实例追踪过的实体,无差别标记为
Added状态
关键注意:EF Core 判断遍历到的关联实体是否需要插入,不会校验这个实体的主键值是否已经在数据库存在,也不会因为客户端传入的对象带了主键值就自动把状态改成
Unchanged。只要这个实体实例没有进入过当前DbContext的追踪缓存,就会被当成待新增的实体处理。
对应到你的场景的触发流程
- 通过AutoMapper把客户端传来的
ProfileDto映射为实体时,直接把DTO中携带的、对应数据库已存在记录的Company对象,赋值给了Profile.Company导航属性。这个Company实例是反序列化/映射生成的全新对象,从来没有被当前DbContext的追踪器识别过 - 执行
AddAsync(profile)时,EF Core从Profile根节点顺着导航属性找到这个游离的Company实例,由于该实体不在追踪缓存中,EF直接把它的状态也标记为Added - 执行
SaveChangesAsync时,EF会按照实体状态生成对应的SQL:除了给新的Profile生成插入语句,也会给这个被标记为Added的Company生成插入语句,最终因为Company的主键值与库中已有记录重复,触发主键约束冲突。
你观察到的“正常运行场景”的原理
- 当你手动把
profile.Company置空时,EF遍历实体图时找不到关联的Company导航实体,自然不会生成针对Company的插入语句,整个流程不会触发冲突 - 当客户端仅传递
CompanyId外键值、不传递完整Company实体对象时,Profile对象上只有标量类型的外键属性,没有挂载对应的导航实体,EF遍历图时找不到需要追踪的关联对象,仅会为Profile生成插入语句,同时正确关联已有的CompanyId外键值,不会触发重复插入。
常见认知误区
很多开发者会误以为“只要实体带了主键值,EF就会自动识别为已存在的记录”,这和EF Core的实际运行机制不符:
- 只有当某个实体实例已经被当前DbContext追踪(比如通过
FindAsync、查询方法从数据库加载过,已经进入上下文的追踪缓存),EF遇到同实例的引用时,才会复用已有的实体状态,不会将其重复标记为Added - 如果是从外部反序列化、映射生成的带主键的游离实体,哪怕主键值完全和库中已有记录一致,只要没有被上下文追踪过,通过新增根实体关联传递时,依然会被标记为待新增状态。
内容的提问来源于stack exchange,提问作者Thabiso Mofokeng
相关产品推荐
相关产品推荐

