jqgrid 在启用工具栏搜索后，若未手动清除搜索状态直接 reloadgrid，会导致后续搜索仅作用于已过滤的子集。本文介绍通过 cleartoolbar(true) 重置搜索条件，并结合 refreshfiltertoolbar 实现真正的全量数据过滤。
在使用 jqGrid 的 Toolbar Search（工具栏搜索）功能时，一个常见却容易被忽视的问题是：搜索状态具有“持久性”——即搜索文本和过滤逻辑会保留在客户端，即使执行 reloadGrid()，只要未显式清除搜索条件，后续输入或清空搜索框的操作仍将基于上一次过滤后的结果集（如 26 条）进行，而非原始完整数据源（如 100 条）。这并非数据丢失，而是 jqGrid 内部的 postData 和搜索控件状态未同步重置所致。
要彻底解决该问题，关键在于分离“数据刷新”与“搜索状态重置”两个动作：
-
清除搜索工具栏状态（核心步骤）
必须调用 clearToolbar(true) 方法（注意参数为 true），它不仅清空搜索输入框的值，还会重置内部 postData 中所有搜索字段（如 searchField、searchString、searchOper），并触发 onSearch 回调（如有）。示例代码如下：function refreshGrid() { // 步骤1：强制清除工具栏搜索状态（含 postData） const grid = $("#grid_id")[0]; if (grid && typeof grid.clearToolbar === 'function') { grid.clearToolbar(true); // ? 关键：true 表示重置所有搜索参数 } // 步骤2：重设数据源参数（可选，若 URL 或 datatype 有变更） $("#grid_id").jqGrid('setGridParam', { datatype: 'json', url: '/api/data' // 确保指向完整数据接口 }); // 步骤3：触发重载（此时 postData 已清空，服务端将返回全部记录） $("#grid_id").trigger('reloadGrid', [{ current: true }]); } -
刷新搜索工具栏 UI（增强体验）
若希望在清除后立即更新工具栏显示（例如清空输入框、重置下拉选项），可额外调用：$("#grid_id").jqGrid('refreshFilterToolbar'); // ? 同步 UI 状态
⚠️ 重要注意事项：
- clearToolbar(true) 必须在 reloadGrid() 之前调用，否则 reload 会携带残留的搜索参数；
- 确保后端接口（url）本身不依赖前端传入的搜索参数做预过滤；若服务端也做了过滤，需确认其接收的是原始请求，而非继承自前次搜索的 postData；
- 若使用了 search: true + multipleSearch: true（高级搜索），clearToolbar(true) 同样适用，它会一并重置所有高级搜索字段；
- 避免仅用 $("#searchInput").val("") 手动清空输入框——这无法清除 jqGrid 内部状态，无效。
✅ 总结：reloadGrid() 本身不会重置搜索上下文。真正恢复“原始数据源过滤能力”的唯一可靠方式，是在每次重载前主动调用 clearToolbar(true)，确保 postData 归零，让后续任意搜索操作都基于服务端返回的全量数据进行。这是 Guriddo jqGrid（及兼容版本）中处理 Toolbar Search 状态管理的标准实践。
