JSON解析报错怎么查?Unexpected token 排查

0 阅读

接口联调,前端报了一行红字:Unexpected token < in JSON at position 0。后端说接口返回正常,我在浏览器里打开也确实能看到数据。

问题就出在这个"能看到数据"上——浏览器打开看到的是 HTML,不是 JSON。

JSON格式化工具界面:左右分栏输入原文并输出格式化结果
粘进格式化工具,错误位置会直接指出来

报错信息怎么看

position 0 是关键字。它说的是"第一个字符就不对",而 JSON 的第一个字符只可能是 {、[、" 或者数字。

如果报的是 Unexpected token <,那个 < 是 HTML 标签的开头。也就是说,你拿到的是一整页 HTML。

报错位置在中间(比如 position 1024),说明前面是对的一部分,问题出在中途被截断或者混入了别的内容。

六个常见原因

一、接口返回了错误页

最常见。路径写错、没带 token、服务端 500,返回的都是 HTML 错误页。状态码可能还是 200,因为有些框架会把错误页当正常响应发出去。

排查:在浏览器的网络面板里看 Response 的原始内容,不要看 Preview 里渲染后的样子。

二、结尾多了一个逗号

{"a": 1, "b": 2,} 这种在 JavaScript 对象字面量里合法,在 JSON 里非法。手写配置最容易犯。

三、用了单引号

JSON 只认双引号。从 Python 或 JS 控制台复制出来的数据经常带单引号。

四、加了注释

JSON 标准不支持 // 和 /* */。带注释的配置文件要先去掉注释再解析。

五、文件开头有 BOM

Windows 下保存的 UTF-8 文件可能带一个看不见的 BOM 头,解析器读到第一个字符就报错,看着内容完全正常。这种情况报错位置通常是 0 或 1。

六、字符串里有没转义的换行

JSON 字符串里不能直接换行,必须写成 \n。多行文本拼接时容易漏掉。

怎么快速定位

把原始内容粘进格式化工具里,它会直接指出第几行第几列出错,比在控制台猜快得多。左半边粘原文,右半边看格式化结果,错误位置会高亮。

JSON格式化格式化、校验和压缩 JSON 文本立即使用

如果内容是一整行没有换行的压缩 JSON,先格式化再找,肉眼几乎不可能在几千个字符里定位一个多余逗号。

绕不过去的两个细节

中文和特殊字符。JSON 里中文可以原样存,也可以转成 \u4e2d 形式,两种都合法。但从某处复制过来时,"全角引号"和"弯引号"会被当成普通字符,导致解析失败——这种问题肉眼极难发现,因为看起来就是双引号。

大数字精度。超过 15 位的整数,某些语言的解析器会自动转成浮点,末尾几位失真。订单号、身份证号这类字段,接口里应该用字符串传,别用数字。

相关工具

要把 JSON 嵌进字符串里传参的,用JSON转义处理引号和换行;结构复杂看不出层级的,JSON 树状查看器能折叠展开;接口返回的是 Base64 编码内容的,先Base64编码解码解开再看。

最后提醒:改完别只在工具里验证通过就完事。把修好的内容放回真实链路跑一次,因为问题经常不在 JSON 本身,而在传过来的路上。

查看更多
网站打不开显示403、502?按状态码分清是谁的问题网站打不开显示403、502?按状态码分清是谁的问题cron表达式怎么写?每5分钟、每天8点的定时任务写法cron表达式怎么写?每5分钟、每天8点的定时任务写法正则表达式怎么写?常用符号含义与实例速查正则表达式怎么写?常用符号含义与实例速查SSL证书还有多久到期?HTTPS证书检查清单SSL证书还有多久到期?HTTPS证书检查清单