JSON解析错误排查教程:Unexpected token、尾逗号和引号问题
JSON 解析失败时不要只盯着报错文案,应该按字符、结构、类型、来源四个方向定位。
最常见的 JSON 解析错误来自尾逗号、中文引号、缺少括号、字符串没有双引号、复制时多带了说明文字。
排查时先缩小范围,再用格式化工具定位具体行列,最后回到接口或配置来源修复。
一、先看报错位置附近
Unexpected token 通常会带一个字符或位置。先截取报错点前后 20 行,检查是否有多余逗号、非法注释、未闭合字符串。
二、优先检查这 5 类问题
- 对象或数组最后一个元素后面多了逗号。
- 字符串使用了单引号或中文引号。
- 对象 key 没有使用双引号。
- 括号、方括号数量不匹配。
- 复制接口响应时混入了日志、HTML 或错误说明。
三、接口返回不是 JSON 怎么办
如果响应看起来不是 JSON,先检查接口状态码和响应头。后端返回 HTML 错误页、登录页或网关错误时,前端再怎么解析都会失败。
常见问题
JSON支持注释吗?
标准 JSON 不支持注释。如果配置文件允许注释,通常它其实是 JSONC 或其他扩展格式。
为什么浏览器能显示,JSON.parse 却失败?
浏览器展示文本不等于它是合法 JSON。需要检查是否有不可见字符、BOM、HTML 或日志前缀。