Ag Grid Quick Search/Pagination时已勾选行偶发取消选中问题咨询

问题现象 #

• 触发Quick Search（快速搜索）过滤、执行Pagination（分页）切换操作时，此前手动勾选的行偶发自动变为未选中状态，影响批量操作等依赖行选择的功能正常使用。

问题根因 #

Ag Grid默认的行选中状态是绑定在当前渲染的行节点实例上的，当触发搜索过滤、分页切换动作时，网格会销毁旧的行节点、重新渲染新的行节点实例，如果没有给行配置固定的唯一身份标识，网格无法匹配新旧节点的对应关系，就会导致原有选中状态丢失。

修复步骤 #

• 配置固定行ID，这是解决该问题的核心配置，给每一行绑定数据中自带的、不会变更的唯一业务主键作为行的固定ID，避免重渲染时节点身份识别失效，配置代码如下：

const gridOptions = {
  // 其余已有配置保持不变
  // 替换yourUniqueKey为实际数据里的唯一主键字段，比如id、userId、tradeNo这类
  getRowId: (params) => params.data.yourUniqueKey
}

• 客户端行模型+跨页选择场景，额外开启选中状态持久化配置：

const gridOptions = {
  // 其余已有配置保持不变
  rowSelection: 'multiple',
  // Ag Grid版本<28.x使用该配置
  rememberGroupStateWhenNewData: true,
  // Ag Grid版本≥28.x使用下方配置替代上述旧配置
  maintainSelectedNodes: true
}

• 服务端行模型场景，不要依赖网格内置的选中状态存储：自行维护一个全局的选中行ID集合，监听onRowSelected事件增删集合内的ID；在分页切换、搜索过滤完成、数据重渲染的回调事件（onPaginationChanged、filterChanged、onFirstDataRendered）中，遍历当前页加载的行节点，匹配集合内的ID手动设置选中状态即可。

注意事项 #

禁止使用数组索引作为行ID，数据排序、过滤、分页后索引会动态变化，依然会触发选中状态错乱问题。

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