chrome 111+ · JavaScript
报错原文
SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
这是什么意思
你交给 JSON.parse 的是 HTML，不是 JSON。消息里引出的 <!DOCTYPE 片段就是证据，它说明服务器返回的是一个 HTML 页面——404、502，或者跳转登录页——所以真正的毛病在解析之前，在那次请求上。典型原因：地址写错、开发服务器的代理把 index.html 当成 API 返回了、会话过期被重定向到登录页。调 res.json() 之前先看 res.ok，不对就用 res.text() 读出到底来了什么；用 curl -s 直接打那个地址是最快的一眼。Chrome 111 和 Node 20 之前，同一个错误写作 Unexpected token < in JSON at position 0。
怎么修
curl -s https://api.example.com/data | head -5- 来自
- chrome 111+
- JavaScript
- 15
浏览器和 node 的错误通常只告诉你什么坏了，不告诉你那个值为什么变成这样——你读了 undefined、它不是函数、它不是 JSON——所以该修的地方在抛错那一行的上游；只用 ?. 和默认值把那一行按住，同样的问题会在更远的地方、以更难辨认的样子回来。
怎么读报错
- 从第一行往下读。越往下越是工具内部的事，起因通常写在最上面。
- 有文件名和行号就从那里查——不是栈顶那一帧，而是最上面那条提到你自己写的文件的行。
- 把报错原文照样去搜，但先去掉你自己的路径和变量名，正是那些让搜索匹配不上。
- 同一种情况在不同版本里措辞不同。结果不对头，就把版本号一起加进查询。
- 粘贴修法之前，先确认它会丢掉什么。这里面有些是不能撤回的。
常见问题
Q. “SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON” 是什么意思？
你交给 JSON.parse 的是 HTML，不是 JSON。消息里引出的 <!DOCTYPE 片段就是证据，它说明服务器返回的是一个 HTML 页面——404、502，或者跳转登录页——所以真正的毛病在解析之前，在那次请求上。典型原因：地址写错、开发服务器的代理把 index.html 当成 API 返回了、会话过期被重定向到登录页。调 res.json() 之前先看 res.ok，不对就用 res.text() 读出到底来了什么；用 curl -s 直接打那个地址是最快的一眼。Chrome 111 和 Node 20 之前，同一个错误写作 Unexpected token < in JSON at position 0。
Q. 怎么修？
curl -s https://api.example.com/data | head -5 —— 执行前先看上面的说明，确认这条命令会丢掉什么。
Q. 这是哪个工具报的？
chrome 111+。它属于JavaScript，报错原文有 10 个词。