解决EF Core添加关联实体时的DbUpdateConcurrencyException异常

可能的触发原因 #

• 父实体Version跟踪异常：虽然加了[Timestamp]标记，但EF上下文加载的父实体Version值和数据库最新值不一致，添加子实体时EF尝试更新父实体（默认修改导航属性会触发父实体状态变更），并发检查失败导致影响行数为0，被误判为对象删除。
• Version映射错误：数据库中Version列类型不符合要求（比如SQL Server需用rowversion而非普通datetime），或者Fluent API/数据注解的配置未生效，EF无法正确生成并发检查的SQL语句。
• 上下文跟踪丢失：父实体是通过无跟踪查询（AsNoTracking）加载的，或被手动移除了跟踪，EF无法识别它是已存在的实体，添加子实体时错误地执行不符合预期的更新逻辑。
• 异常处理逻辑误判：把所有DbUpdateConcurrencyException都归为“对象已删除”，但实际是Version不匹配的并发修改，而非实体真的被删除。

对应解决办法 #

1. 确保父实体跟踪状态与Version值正确 #

• 若父实体是无跟踪加载的，手动附加并同步最新Version：

  // 从数据库拉取最新的父实体Version
  var latestPartner = dbContext.BusinessPartners.AsNoTracking()
                          .First(p => p.Id = existingPartner.Id);
  existingPartner.Version = latestPartner.Version;
  // 附加到上下文并标记为已修改
  dbContext.Entry(existingPartner).State = EntityState.Modified;
  

• 或者直接重新加载父实体的最新状态：

  dbContext.Entry(existingPartner).Reload();
  

2. 验证Version属性的映射配置 #

• 检查数据库表的Version列：SQL Server需设为rowversion类型，MySQL用timestamp并开启自动更新，PostgreSQL可使用xmin列。
• 用Fluent API显式配置（比数据注解更可靠）：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<BusinessPartner>()
          .Property(p => p.Version)
          .IsRowVersion(); // 对应SQL Server的rowversion，其他数据库需调整
  }
  

3. 避免父实体不必要的更新 #

• 直接通过子实体的外键关联父实体，而非修改父实体的导航集合，这样EF只会插入子实体，不会触发父实体的并发检查：

  var newScraper = new BPLayerXScraper
  {
      BusinessPartnerId = existingPartner.Id,
      // 填充其他属性
  };
  dbContext.BPLayerXScrapers.Add(newScraper);
  dbContext.SaveChanges();
  

4. 修正并发异常的处理逻辑 #

• 不要直接判定为“对象已删除”，通过异常的Entries区分真实原因：

  catch (DbUpdateConcurrencyException ex)
  {
      foreach (var entry in ex.Entries)
      {
          var dbValues = entry.GetDatabaseValues();
          if (dbValues == null)
          {
              // 实体确实被删除，执行对应逻辑
          }
          else
          {
              // 并发修改：同步数据库最新Version到上下文
              entry.OriginalValues.SetValues(dbValues);
              // 重新添加子实体（如果之前的操作因异常未生效）
              var partner = entry.Entity as BusinessPartner;
              partner?.BPLayerXScrapers.Add(newScraper);
              // 再次尝试保存
              dbContext.SaveChanges();
          }
      }
  }
  

5. 排查外部修改因素 #

• 检查是否有数据库触发器、EF拦截器或其他异步操作，在添加子实体的同时修改了父实体的Version字段，导致上下文跟踪的Version失效。

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