Entity Framework Core批量INSERT语句的行数决策逻辑及配置方法

你观察到的现象完全正确——EF Core拆分批量INSERT批次的核心依据是数据库查询的参数数量上限，以SQL Server为例，其单条查询允许的最大参数数默认是2100。

为什么会分成两次4条插入？ #

当你插入主表+8条明细时，EF Core会先执行主表的INSERT操作（这会占用少量参数，比如主表字段对应的参数、获取自增主键的输出参数），剩余的参数额度会分配给明细的批量插入。每条明细的每个字段对应一个参数，EF Core会自动计算当前批次能容纳的明细记录数：当新增一条明细的参数会让总参数数接近甚至超过2100的上限时，就会拆分出一个新的批次。你看到的@p1999就是接近这个阈值的表现，此时再加入下一条明细的参数就会触发上限，所以EF Core会把8条明细拆成两个4条的批次。

这个逻辑是否可以配置？ #

当然可以，你可以通过以下两种方式调整：

1. 限制每个批次的最大记录数：
   在DbContext的配置中，通过MaxBatchSize指定每个批次最多插入多少条记录。比如你想让8条明细一次插入，可以设置：

   protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
   {
       optionsBuilder.UseSqlServer(
           "你的连接字符串",
           opt => opt.MaxBatchSize(8)
       );
   }
   

   注意：这个值不能设置过大，否则总参数数超过数据库上限时依然会被拆分。
2. 调整最大参数数限制：
   从EF Core 6开始，还可以通过MaxParameterCount直接指定单条查询允许的最大参数数，比如：

   protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
   {
       optionsBuilder.UseSqlServer(
           "你的连接字符串",
           opt => opt.MaxParameterCount(2000)
       );
   }
   

   这个值不能超过数据库本身的参数上限（SQL Server默认2100），否则会抛出数据库异常。

另外需要注意：主表与明细表的插入顺序是EF Core自动维护的（先主后从，确保明细能获取到主表的外键值），这部分逻辑无法修改，但主表插入占用的参数会影响明细批次的大小计算。

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