jqgrid 在启用工具栏搜索后，若仅调用 reloadgrid() 而未重置搜索状态，会导致后续过滤仅作用于已缓存的子集（如 26 条），而非原始全量数据（如 100 条）。本文详解如何正确清除搜索条件、刷新工具栏并恢复完整数据源过滤能力。
在使用 jqGrid 的高级搜索或工具栏搜索（filterToolbar）功能时，一个常见但易被忽视的问题是：reloadGrid() 并不会自动清除前端已应用的搜索条件。当用户输入关键词过滤出部分记录（例如从 100 条筛出 26 条），再执行编辑并调用 reloadGrid() 后，Grid 内部的搜索状态（如 postData.filters 或工具栏输入值）依然保留。此时若用户修改或清空搜索框，jqGrid 实际执行的是对「当前已加载的 26 条」进行二次过滤——而非向后端重新请求全部 100 条后再过滤。
要彻底解决该问题，关键在于 显式重置搜索上下文，而非仅刷新数据。以下是推荐的三步处理方案：
✅ 正确做法：清除 + 刷新 + 重载
function refreshGrid() {
var $grid = $('#grid_id');
var gridDOM = $grid[0];
// Step 1: 清除工具栏搜索状态（true 表示同时清空输入框和内部 filter 状态）
if (gridDOM.clearToolbar) {
gridDOM.clearToolbar(true);
}
// Step 2: （可选）强制刷新过滤工具栏 UI，确保输入框视觉重置
if (gridDOM.refreshFilterToolbar) {
gridDOM.refreshFilterToolbar();
}
// Step 3: 重置数据源参数并触发重载（确保下次请求为全量数据）
$grid.jqGrid('setGridParam', {
datatype: 'json',
url: 'URL', // 确保此 URL 不带客户端过滤参数
postData: {} // 清空可能残留的 filters/postData（尤其使用 JSON string filters 时）
});
$grid.trigger('reloadGrid', [{ current: true }]);
}⚠️ 注意事项
- clearToolbar(true) 是 Guriddo jqGrid（v5.0+）及部分兼容版本的核心方法；若使用旧版 free jqGrid 或原生 jqGrid，需改用 $("#grid_id").jqGrid("destroyFilterToolbar") 后重建，或手动清空 postData.filters 并调用 setGridParam({ postData: {...} })。
- 确保后端接口 URL 不依赖前端缓存的过滤逻辑。例如，避免在 JS 中拼接 ?search=xxx 到 URL —— 应始终由 postData 或 filters 对象统一传递，服务端据此决定是否过滤。
- 若启用了 search: true 和 multipleSearch: true，还需检查 postData.filters 是否为 JSON 字符串，必要时设为 null 或 {}：
$grid.jqGrid('setGridParam', { postData: { filters: null } }); - 建议在 beforeRequest 事件中统一日志输出 postData，便于调试过滤参数是否残留。
? 补充：监听搜索框变化时的防御性处理
为防止用户手动修改搜索框后仍受限于子集，可在工具栏输入事件中主动干预：
// 假设工具栏输入框 class 为 'ui-search-input'
$('#grid_id').on('input', '.ui-search-input', function() {
// 检测到搜索行为变更，可提前清理潜在脏状态（非必须，但增强鲁棒性）
var $grid = $('#grid_id');
if ($grid[0].clearToolbar) {
$grid[0].clearToolbar(false); // false：不清空输入框，只重置内部状态
}
});通过以上方式，即可确保每次 reloadGrid() 后，Grid 始终基于原始全量数据源响应新的搜索请求，彻底规避“越搜越少”的陷阱。
