本文介绍解决 jqgrid 在启用 toolbar search 后调用 `reloadgrid()` 导致数据源被意外截断的问题：通过手动清除搜索状态并重置过滤器，确保后续搜索始终基于原始全量数据源。
在使用 jqGrid 的 Toolbar Search（工具栏搜索）功能时，一个常见但容易被忽视的陷阱是：当用户输入搜索文本并触发筛选后，jqGrid 内部会缓存当前的过滤条件，并在后续 reloadGrid() 调用中默认复用该过滤上下文——即使你已更新了 url 或 datatype。这导致看似“刷新”的网格，实际只对上一次筛选后的子集（如 26 条）重新请求，而非原始全量数据（如 100 条），从而造成搜索范围持续收缩。
根本原因在于：reloadGrid() 不会自动重置 Toolbar 的搜索状态。它仅根据当前 postData（含已应用的搜索参数）发起新请求，而这些参数仍保留着上次 filterToolbar() 所生成的过滤条件。
✅ 正确做法是在调用 reloadGrid() 前，显式清除工具栏过滤器状态：
function refreshGrid() {
// 1. 清除 Toolbar 搜索状态（关键步骤！）
const grid = $("#grid_id")[0];
if (grid && typeof grid.clearToolbar === 'function') {
grid.clearToolbar(true); // true 表示同时清空输入框值并重置内部过滤器
}
// 2. 重置数据源参数（可选，但推荐明确指定）
$("#grid_id").jqGrid('setGridParam', {
datatype: 'json',
url: 'your-backend-api-url'
});
// 3. 触发刷新（此时 postData 已不含残留过滤参数）
$("#grid_id").trigger('reloadGrid');
}⚠️ 注意事项：
- clearToolbar(true) 是 Guriddo jqGrid（v5.0+）及部分兼容版本中的标准方法；若使用经典 jqGrid（v4.x），需改用 $("#grid_id").jqGrid('destroyFilterToolbar') + 重建，或手动清空 postData 中的搜索字段（如 delete postData.searchString）；
- 若启用了 search: true 的 navGrid 高级搜索，clearToolbar() 不会影响高级搜索窗口的状态，二者独立维护；
- 刷新后如需恢复之前的搜索文本（例如用户编辑完数据想继续原条件筛选），应在 clearToolbar(true) 后手动设置：
$("#grid_id").jqGrid('setGridParam', { postData: { searchString: 'your_previous_text', searchField: 'name', searchOper: 'cn' } }); - 推荐在编辑操作完成、准备刷新前统一调用 refreshFilterToolbar()（Guriddo 提供的辅助方法），它会同步更新 UI 输入框与内部过滤逻辑，避免视觉与行为不一致。
总结：reloadGrid() 本身不负责清理搜索上下文。要保证每次刷新都面向原始数据源，必须主动调用 clearToolbar(true) 彻底解除过滤绑定——这是保障搜索功能健壮性的关键实践。
