接口联调,前端报了一行红字:Unexpected token < in JSON at position 0。后端说接口返回正常,我在浏览器里打开也确实能看到数据。
问题就出在这个"能看到数据"上——浏览器打开看到的是 HTML,不是 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 里中文可以原样存,也可以转成 \u4e2d 形式,两种都合法。但从某处复制过来时,"全角引号"和"弯引号"会被当成普通字符,导致解析失败——这种问题肉眼极难发现,因为看起来就是双引号。
大数字精度。超过 15 位的整数,某些语言的解析器会自动转成浮点,末尾几位失真。订单号、身份证号这类字段,接口里应该用字符串传,别用数字。
相关工具
要把 JSON 嵌进字符串里传参的,用JSON转义处理引号和换行;结构复杂看不出层级的,JSON 树状查看器能折叠展开;接口返回的是 Base64 编码内容的,先Base64编码解码解开再看。
最后提醒:改完别只在工具里验证通过就完事。把修好的内容放回真实链路跑一次,因为问题经常不在 JSON 本身,而在传过来的路上。