ag-grid中使用applyTransaction添加行失败的排查求助

针对ag-grid 27.3.0/28.1.1版本中调用applyTransaction添加行时触发的上述错误，可按以下步骤排查：

• 检查排序相关配置与状态
  错误栈指向SortService的sort方法，优先排查排序逻辑异常：

  • 查看列定义中是否存在配置异常的排序项，比如列未设置field但开启了sortable，或sortModel中包含无效的列ID（对应列不存在）。
  • 确认添加行时grid是否处于活跃排序状态，可临时调用api.setSortModel([])清空排序后再执行添加操作，验证是否因排序逻辑触发报错。

• 验证addIndex参数的合法性
  代码中使用this.rowData.length - 1作为addIndex，需确认：

  • this.rowData是否与grid内部维护的行数据完全同步，避免因本地数据与grid实际数据不一致导致索引越界或位置异常。
  • 尝试移除addIndex参数直接添加行，若报错消失，则说明索引计算逻辑存在问题。

• 检查新添加行的数据结构
  确认新行value的字段是否与现有列配置匹配：

  • 重点检查排序列对应的字段是否存在、类型是否符合预期，避免因新行缺失排序字段或字段值为undefined/null，导致排序逻辑处理时触发异常。

• 排查rowData的引用一致性
  确认是否存在直接修改rowData而非通过grid API更新数据的场景，这种操作会导致grid内部状态与外部数据不同步，添加行时触发排序逻辑出错。

• 构建最小复现场景
  创建仅包含核心grid配置和添加行代码的极简demo，逐步引入原有项目中的列定义、插件、自定义逻辑等，定位触发错误的具体配置或代码。

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