Layui表格不支持跨系统数据源自动整合，必须通过parseData统一为code、msg、count、data四字段结构；卡在loading主因是elem无效、field不匹配或count缺失/非数字。
直接说结论：layui 表格本身不支持跨系统数据源的“自动整合”，它只认一种结构——code、msg、count、data 四字段 json 响应。所谓“跨系统”，本质是把不同后端返回格式统一成这个结构，靠前端适配，不是靠 layui 自动转换。
为什么 table.render() 会卡在 loading 状态？
常见现象：调用 table.render() 后表格空白，控制台无报错，network 面板看到接口已成功返回数据，但表格就是不渲染。
根本原因只有三个：
-
elem指向的 DOM 节点不存在或尚未挂载（比如写在$(document).ready()外、或 Vue/React 组件未完成 mount） -
cols中某个field名与后端返回字段名不完全一致（大小写、下划线、驼峰混用，如后端返回user_name，但配置了field: 'username'） - 接口返回 JSON 缺少
count字段，或code是字符串"0"（layui 只认数字0）
只要其中任一条件不满足，layui 就静默失败——它不会抛异常，也不会提示你哪错了。
对接多个后端系统时，parseData 是唯一可靠入口
不同系统返回格式五花八门：{ result: [...], total: 123 }、{ data: { list: [...], pagination: { total: 123 } } }、甚至带嵌套 data.rows 和 data.totalCount。你不能改每个后端，只能在前端做归一化。
parseData 回调就是干这事的，它在收到原始响应后、渲染前执行，必须返回标准结构：
table.render({
elem: '#userTable',
url: '/api/v1/users',
parseData: function(res) {
// 假设某系统返回：{ code: 200, data: { items: [...], totalCount: 45 } }
return {
"code": res.code === 200 ? 0 : res.code,
"msg": res.message || "",
"count": res.data?.totalCount || res.data?.total || 0,
"data": res.data?.items || res.data?.list || []
};
},
cols: [[
{field: 'id', title: 'ID'},
{field: 'username', title: '用户名'} // 注意：这里 field 必须和 parseData 返回的 data 数组中对象的 key 严格一致
]]
});
关键点：
-
parseData里不能做异步操作（比如再发个请求），它必须同步返回对象 - 返回的
data必须是数组；count必须是数字，哪怕本地分页也要填 - 如果多个系统字段命名差异大（比如一个叫
full_name，另一个叫realName），建议在parseData里统一重映射成你 cols 定义的字段名，而不是在列配置里写别名
reload 时 where 参数容易被覆盖，导致筛选丢失
场景：用户先按状态=1 查询，再输入关键词搜索，期望结果是“状态=1 且包含关键词”。但调用 table.reload() 后发现状态筛选没了。
因为 where 是完全替换，不是合并。以下写法会丢掉之前的状态：
// ❌ 错误：只传 keyword，status 就丢了
table.reload('userTable', {
where: { keyword: 'admin' }
});
正确做法是显式维护一个参数对象，并每次完整传入：
// ✅ 正确：始终携带全部筛选条件
let searchParams = { status: 1 };
// 用户输入关键词后
searchParams.keyword = 'admin';
table.reload('userTable', {
where: searchParams,
page: { curr: 1 } // 搜索后回到第 1 页
});
额外注意：
-
table.reload()不会自动重置当前页码，翻页逻辑仍按原page.curr执行，所以搜索类操作务必加page: { curr: 1 } - 如果使用了
request自定义请求函数，where会被透传进request，但依然要自己处理合并逻辑
最常被忽略的其实是 parseData 的返回值校验——很多人写了回调却没检查 count 是否为数字、data 是否为数组。一旦类型不对，表格就停在 loading，连 console.warn 都没有。建议在 parseData 开头加个 console.log(res)，看一眼原始响应长什么样，比对着文档猜强十倍。
