Unexpected token报错：原因、定位与修复

最后更新：2026年10月30日 · 当前文案基于Node V8实测，旧版文案用于对照

JSON解析时看到Unexpected token，通常不是这个字符本身有问题，而是它前面的引号、逗号、括号，或者数据来源出了问题。本文按报错里的关键字逐个拆解，并给出可直接复制的修复示例。

本文覆盖：Unexpected token in JSON、Unexpected token < in JSON at position 0、Unexpected token o in JSON at position 1、Unexpected token u in JSON at position 0、Unexpected token ' in JSON等常见变体。

本站数据在浏览器本地处理，不上传服务器。修复需要手动点击，不会自动改你的数据。

先看懂报错：position、行号列号和新旧文案

JSON解析器会逐个字符读取输入。遇到不符合语法的字符时，解析器抛出Unexpected token。报错里的position是解析器失败的位置，真正的原因常常在它前面1至2行。

V8是Chrome、Edge、Node.js使用的JavaScript引擎。JSON.parse的报错文案在不同版本中改过，下面两种写法都可能出现。

表中的位置和行列以实际输入为准。单引号在键名位置时，较新V8通常报Expected property name or '}'；在值位置时报Unexpected token '''。Firefox和Safari的报错文案不同，但原因和修复方法相同。

按报错关键字查原因

先按报错里出现的关键字分流，再进入下面的详细原因。新旧文案都能用这张表。

五种最高频原因与修复

Unexpected token <：接口返回了HTML

这是最常见、也最容易误判的一种。<不是JSON里的字符，它通常意味着你拿到的是一个HTML页面。

Unexpected token '<', "<!DOCTYPE html>..." is not valid JSON

最小复现：

const res = await fetch('/api/user');
const data = await res.json();

先别改JSON，先看请求：

const res = await fetch('/api/user');
const raw = await res.text();
console.log(res.status);
console.log(res.headers.get('content-type'));
console.log(raw.slice(0, 200));

常见原因：

• 接口地址写错，命中了前端路由，返回index.html。
• 登录态失效，被重定向到登录页。
• 后端返回500，响应体是HTML错误页。
• Nginx或网关把JSON响应替换成了HTML。
• 本地代理配置错误。

修复：确认status是200，Content-Type包含application/json，再解析。不要把HTML当JSON修。可以先把真实响应粘贴到JSON校验工具，确认它到底是不是JSON。

尾随逗号

最小复现：

{
  "name": "Alice",
  "age": 30,
  "city": "Tokyo",
}

报错通常包含Expected double-quoted property name，较新V8可能带(line 5 column 1)。

修复：删除最后一个逗号。

{
  "name": "Alice",
  "age": 30,
  "city": "Tokyo"
}

也可以直接粘贴到JSON格式化工具，点“修复”。

单引号

最小复现：

{
  "name": "Alice",
  "city": 'Tokyo'
}

报错通常包含Unexpected token '''。

如果单引号出现在键名位置，较新V8通常报Expected property name or '}'。

修复：JSON只允许双引号。改成双引号，字符串里的撇号需要转义。

{
  "name": "Alice",
  "city": "Tokyo"
}

单引号、尾随逗号和注释混在一起时，粘贴到JSON格式化工具点“修复”更快。

注释

最小复现：

{
  // 用户名
  "name": "Alice"
}

报错通常包含Expected property name or '}'。

修复：标准JSON不支持注释。删除注释，或改用YAML、JSONC、JSON5。浏览器原生JSON.parse不接受注释。需要临时处理时，可以粘贴到JSON格式化工具点“修复”。

BOM

最小复现：文件开头有不可见的U+FEFF，十六进制为EF BB BF。

\uFEFF{"name":"Alice"}

报错位置通常在0，较新V8会引用一个看起来像空白的字符。

修复：另存为UTF-8无BOM，或在代码里去掉。

const cleaned = text.replace(/^\uFEFF/, '');
JSON.parse(cleaned);

也可以直接粘贴到JSON格式化工具点“修复”。

其他常见写法

不是语法错：空响应、截断和类型错误

有些Unexpected token并不是JSON语法问题，而是解析之前的数据就错了。

• Unexpected end of JSON input：空字符串、响应被截断、文件没写完。
• JSON.parse(undefined)：传入undefined，报错里可能包含undefined或旧版u。
• JSON.parse(object)：传入对象，报错里包含[object Object]或旧版o。
• 服务端返回HTML：报错里包含<。

安全的解析顺序是先读文本、看状态码，再解析：

const res = await fetch('/api/user');
const raw = await res.text();

if (!res.ok) {
  console.error(`HTTP ${res.status}`, raw.slice(0, 200));
} else if (!raw) {
  console.error('响应体为空');
} else {
  try {
    const data = JSON.parse(raw);
  } catch (e) {
    console.error('JSON解析失败:', e.message, raw.slice(0, 200));
  }
}

怎么避免再次出现

• 用JSON.stringify()生成JSON，不要手拼字符串。
• 解析前先看response.status和Content-Type。
• 先response.text()，打印前200个字符，再JSON.parse。
• 编辑器开启JSON校验，CI加一条python -m json.tool或jq empty。
• 不确定数据来源时，先校验再处理。

本站怎么帮你

• 标出错误所在的行和列。
• 中文提示，不要求读者先理解V8英文文案。
• 一键修复尾随逗号、单引号、注释、未加引号的key、BOM、Python dict、截断JSON。
• 格式化和压缩保留大整数，不会把订单号悄悄改写。
• 数据在浏览器本地处理，不上传服务器。
• 修复需要手动点击，不会自动改用户数据。

常见问题

相关阅读

• JSON错误排查专题：按报错类型查看全部排查指南。
• JSON校验工具：粘贴JSON和报错，直接定位行列。
• JSON格式化工具：格式化、压缩和一键修复。
• JSON解析工具：解析JSON字符串并查看结构。
• JSON解析错误处理与常见问题：系统排查常见解析错误。
• JSON语法基础：键值对、引号、逗号和括号规则。