layui table.reload()必须显式传where函数和page:{curr:1}，否则参数失效或页码错乱；where须动态取值并过滤空值，url、id、字段名须与后端严格一致。
table.reload() 只认 where 字段，其他字段全被忽略——这是 Layui 的设计逻辑，不是 bug。传参失效 90% 都卡在这儿。
where 必须是对象，且得动态取值
写死对象或直接读 DOM 值（如 where: { keyword: $('#kw').val() }）只在初始化时生效，后续输入变化不会更新。每次 reload 都要重新执行取值逻辑。
- 正确做法是用函数：
where: () => ({ q_name: $('#kw').val().trim(), status: $('#status').val() }) - 空值要主动过滤：
if (val) params.q_name = val，避免后端把空字符串当有效条件 - 多个控件建议统一收口：
const where = {}; if ($('#kw').val().trim()) where.q_name = ...; return where; - 别在
where函数里调用table.reload()，会无限循环
page.curr 必须显式重置为 1
用户在第 5 页点搜索，不重置 curr，请求仍带 page=5，结果返回空数组，UI 显示「第 5 页 / 共 0 页」——这是最常被忽略的视觉错乱点。
- 每次搜索、重置、条件变更，都必须加
page: { curr: 1 } - 别依赖
tableIns.config.page.curr读当前页，它可能还没更新；写死{ curr: 1 }最稳妥 - 老版本 Layui（2.5.6 之前）对
page.curr处理有 bug，建议升级到 2.8+ 或强制传该配置
url、id、参数名三者必须严格一致
传参失败，80% 是这三处低级但难察觉的问题：
-
table.reload('userTable', {...})中的'userTable'必须和table.render({ id: 'userTable', ... })的id完全一致，大小写、下划线都不能错 - 后端字段名要匹配：如果接口要的是
q_name，就不能只传keyword；查 Network 里实际 URL 的 key 名 - 动态换接口？不能改
tableIns.config.url（只读快照），必须在reload里显式传url: '/api/v2/list' - POST 模式下，后端需支持解析原始 JSON（如 Express 要配
bodyParser.json()）
空搜索怎么清空条件又不传空值
下拉选“全部”、输入框为空时，若把 { keyword: '', status: '' } 塞进 where，后端可能误判为“查空字符串”，导致 SQL 异常或缓存命中。
- “全部”选项建议设
value=""或null，再统一过滤 falsy 值 - 用
new FormData(formEl)收集表单时，记得先Object.fromEntries()，再删掉空字段 -
where: {}才算真正清空；where: null、where: undefined或where: { keyword: '' }都会沿用上次缓存值 - 日期控件返回
"2024-01-01"，后端要"2024/01/01"就得前端先格式化，别指望后端自动转换
真正容易被忽略的是：哪怕只是想“重新拉一遍当前页”，也得把 url、where、page 全部显式传进去——少一个，行为就不可控。尤其是 where 为空对象和不传 where，Layui 处理方式完全不同。
