讲师中心 微信公众号
AI工具推荐 视频效率加速

layui表格数据渲染失败怎么排查原因

大强姑娘_5222

大强姑娘_5222

发布时间:2026-09-06 08:42:33

|

563人浏览过

|

来源于php中文网

原创

Network面板中请求未发出、状态码异常或响应体为HTML/空字符串,90%非前端代码错误而是请求失败;Layui表格要求后端返回含code、msg、count、data四字段的JSON,data须为数组、code/count须为数字,field需与后端字段严格一致,避免length等干扰属性。

layui表格数据渲染失败怎么排查原因

看 Network 面板里请求发没发出、状态码和响应体

“No data”或“接口异常”提示,90% 的情况根本不是前端代码写错,而是请求压根没成功。先打开浏览器开发者工具的 Network 标签页,筛选 XHR,找到对应表格的请求:

  • 如果连请求记录都没有 → 检查 elem 是否指向一个还不存在的 DOM 节点(比如 table.render 执行太早,div#demo 还没插入页面)
  • 如果有请求但状态码是 404 → 确认 url 是绝对路径还是相对路径,后端接口是否真实存在、路由是否配对(例如 Spring Boot 类上写了 @RequestMapping("/api"),方法又写 @GetMapping("/list"),完整路径必须是 /api/list)
  • 如果状态码是 502、401 或 0(跨域/网络中断)→ parseData 不会触发,只能靠 error 回调捕获,此时响应体可能是 HTML 错误页或空字符串
  • 如果状态码是 200 但 Preview 显示 <html> 开头 → 大概率被重定向到登录页或网关错误页,检查 Response Headers 中的 Location 字段

确认后端返回结构是否符合 Layui 默认要求

Layui 表格默认只认四字段顶层 JSON:code、msg、count、data。缺一个或类型不对,就会静默失败。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
  • data 必须是数组(哪怕空数组 []),不能是对象、null 或字符串
  • code 必须是数字,非 0 即失败;count 也必须是数字(不能是字符串 "100")
  • 后端若返回纯数组(如 [{"id":1}])或仅包裹 data(如 {"data":[...]}),Layui 会直接报“接口异常”
  • 用 parseData 做兼容转换时,必须 return 一个含这四个键的对象,漏写 return 或返回了 undefined,表格就卡住不渲染

检查 cols 中 field 和后端字段名是否严格一致

字段名大小写、下划线/驼峰、特殊字符(如短横线)不匹配,会导致某列为空;整行所有 field 都取不到值,视觉上就像“没数据”。

  • 用 console.log(res.data[0]) 打印第一行原始数据,逐个验证 row['user_name']、row['userName'] 是否能取到值
  • 字段含短横线(如 create-time)时,field 写成 'create-time',但取值必须用方括号语法:row['create-time'],不能用点号
  • 避免在 field 中写 'user.name' —— Layui 不支持嵌套取值,需改用 templet 函数手动提取
  • 字段名为 JavaScript 关键字(如 class、default)时,后端需重命名(如 class_name),否则解析阶段可能被意外覆盖或忽略

留意 length 字段等隐藏陷阱

某些后端返回的数据中带 length 属性(例如从数据库 ORM 直接映射出来的对象),Layui 在内部遍历时会把它当数组长度处理,导致 length: 0 的行被跳过,表面看就是“部分数据不显示”。

  • 在 parseData 中对 res.data 做一次清洗:data.map(item => { delete item.length; return item; })
  • 同理,检查是否有其他干扰属性:如 __ob__(Vue 响应式)、_id(MongoDB)、$$hashKey(Angular)等,都建议在 parseData 中剔除
  • 别依赖后端“保证字段干净”,前端做一层防御性处理成本更低、更可控
真正卡住排查的,往往不是逻辑多复杂,而是某个 field 少了个下划线,或者 count 被后端转成了字符串,又或者 length 字段悄悄吃掉了一半数据 —— 这些细节在 Network 里看不到,得靠 console.log 和逐字段比对才能揪出来。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2303

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4983

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6070

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5578

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

783

2024.05.22

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2035

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2962

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

996

2023.10.13

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.7万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.9万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn