Entity Framework Core中DbSet.AddRange()批量插入失效问题排查

以下是可能导致仅最后一个对象被保存的原因及对应解决方法：

• 实体主键重复或未正确生成
  如果Operation实体的主键是手动赋值，且列表中多个对象使用了相同的主键值，EF Core会将这些对象视为同一实体的重复更新，最终仅保留最后一次修改的结果。
  解决：给主键字段添加[DatabaseGenerated(DatabaseGeneratedOption.Identity)]特性，让数据库自动生成主键；若需手动赋值，确保每个实体的主键值唯一。

• DbContext生命周期异常
  如果调用AddMany时，每次都新建了DbContext实例，或者当前DbContext已经在跟踪列表中的部分实体，会导致状态冲突，无法正常批量插入。
  解决：确保DbContext使用Scoped生命周期（依赖注入中配置为services.AddDbContext<YourDbContext>(options => ...)），且调用AddRange前没有其他代码跟踪这些实体。

• 实体状态被意外修改
  在AddRange执行后、SaveChanges之前，若有其他代码将实体的EntityState修改为Unchanged或Detached，会导致这些实体不被持久化。
  解决：检查AddRange到SaveChanges之间的逻辑，避免手动修改实体状态。

• 数据库约束冲突导致部分插入终止
  前面的实体可能违反了数据库约束（如唯一键冲突、非空字段未赋值），EF Core默认遇到第一个错误就终止插入，若未捕获异常，会误以为仅最后一条保存成功。
  解决：

  1. 捕获DbUpdateException，查看内部异常的详细错误信息；
  2. 检查Operation实体的所有字段是否符合数据库约束要求。

• 传入的集合存在无效数据
  调用AddMany时传入的IList<Operation>可能仅最后一个是全新实体，其余已被DbContext跟踪（比如是从数据库查询出来的对象），AddRange对已跟踪实体不会执行插入操作。
  解决：调用前验证集合的元素数量及每个实体的状态，确保所有对象都是未被跟踪的新实体。

验证代码示例 #

可以在AddMany中添加日志，排查实体状态和插入结果：

public virtual async Task AddMany(IList<TEntity> entities)
{
    Console.WriteLine($"待插入实体数量：{entities.Count}");
    foreach(var entity in entities)
    {
        var state = Db.Entry(entity).State;
        Console.WriteLine($"实体状态：{state}");
    }
    
    DbSet.AddRange(entities);
    var affectedRows = await SaveChanges();
    Console.WriteLine($"实际影响行数：{affectedRows}");
}

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