JQGrid出现行与id不匹配、错位一行且末行重复问题如何排查

按优先级从高到低排查以下方向即可：

• 优先核对数据源主键配置：检查jsonReader（或xmlReader）中配置的行id字段映射规则是否和后端返回结构匹配。JQGrid渲染时会以配置的id字段作为每行tr的唯一标识，如果返回的数据集首条数据缺失对应id字段、或存在重复id值，会直接导致首行渲染空占位，所有数据行整体下移一位，缺失的行位置会自动复用最后一条数据填充，刚好对应描述的故障表现。
• 核对分页参数返回值：检查接口返回的总记录数records字段值是否和当前页实际返回的列表长度一致。如果records值比实际返回的数据条数多1，JQGrid会按照总记录数计算需要渲染的行数，差的1行就会取最后一条数据重复渲染，连带引发行顺序和id匹配错位。
• 排查自定义表格插入逻辑：检查是否存在手动往表格插入自定义行的代码，比如在gridComplete事件里插入汇总行、提示行时，如果直接往tbody首位置插入tr但没有同步更新JQGrid内部的行缓存，就会把原生数据行整体挤下去一位，出现顺序错位。
• 排查重载/重绘调用逻辑：检查是否存在重复触发reloadGrid、重复调用addRowData批量插数据的问题，尤其是在表格初始化未完成时提前执行数据插入逻辑，会导致初始空行和后续加载的数据行叠加，引发顺序错乱。
• 核对自定义行操作代码：如果有手动调用delRowData、addRowData、setRowData的逻辑，检查传入的行索引计数是否正确——JQGrid内部行索引起始值为1，如果自定义逻辑按数组0索引导入行操作，会导致第一行操作命中第二行，连锁引发全表行和id匹配错位。
• 排查版本兼容问题：如果使用的是4.6及更早的老版本jqGrid，该版本存在空id值触发的行渲染错位已知bug，要么给所有行id加非空兜底，要么升级到后续稳定修复版即可解决。

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