Dapper Plus BulkInsert参数超范围报错 如何定位具体异常数据行

Parameter value '7900000000000000.000000' is out of range是底层数据库驱动抛出的参数范围错误，原生报错不会携带具体数据行信息，可通过以下三种方案快速定位脏数据：

• 利用组件自带的BulkError事件直接捕获异常行
  Z.Dapper.Plus内置了批量操作的错误回调钩子，不需要牺牲批量插入性能，只要在执行插入前注册对应实体的错误事件，异常触发时就能直接拿到问题行实体：

  // 配置对应实体的批量插入错误回调
  DapperPlusManager.Entity<Order>() // 替换成你的实际实体类型
      .BulkError += (s, args) =>
      {
          // args.Entity就是触发异常的单条数据
          // 这里可以直接把问题行的主键、字段值、索引写入日志
          Console.WriteLine($"插入异常，问题行数据：{System.Text.Json.JsonSerializer.Serialize(args.Entity)}，错误信息：{args.Exception.Message}");
          // 配置为true可跳过当前错误行继续插入剩余数据，false则直接终止抛出异常
          args.Continue = false;
      };
  
  // 原有批量插入逻辑不需要改动
  conn.BulkInsert(insertList);
  

  这个方式定位精度是单条数据级别，不需要提前遍历全量数据，对插入性能几乎无影响。
• 插入前做前置字段范围校验
  从报错值来看，7900000000000000.000000明显超出了常规数值字段的存储上限，比如SQL Server的decimal(18,6)最大仅支持存储999999999999.999999，可以在插入前遍历集合，提前筛出超出字段范围的脏数据：

  // 按数据库字段实际精度配置最大最小值，这里以decimal(18,6)为例
  decimal maxValid = 999999999999.999999m;
  decimal minValid = -999999999999.999999m;
  var badRows = insertList
      .Select((item, idx) => new { Data = item, RowIndex = idx })
      .Where(x => x.Data.Amount > maxValid || x.Data.Amount < minValid) // 替换成你实际的数值字段名
      .ToList();
  
  if (badRows.Any())
  {
      // 直接输出所有脏数据的行号和内容，不需要执行插入就能定位问题
      Console.WriteLine($"检测到{badRows.Count}条数值越界脏数据：");
      badRows.ForEach(r => Console.WriteLine($"行号：{r.RowIndex}，数据：{System.Text.Json.JsonSerializer.Serialize(r.Data)}"));
      // 可选择剔除脏数据后再执行插入
      insertList = insertList.Except(badRows.Select(r => r.Data)).ToList();
  }
  

• 分片插入缩小排查范围
  临时排查问题时，可以把待插入的大集合按小批次（比如50~100条一组）拆分后逐批执行BulkInsert，哪一批抛出异常，就只需要排查这一批次的数据，能快速把排查范围从全量数据缩小到几十上百条级别，不需要额外配置组件。

注意：如果配置了BatchSize参数，BulkError事件依旧会精准返回触发异常的单条实体，不会返回整个批次的数据，不需要担心定位范围变大。

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