JSON 的语法只有几条,但线上事故里最常见的仍然是「多了一个逗号」。浏览器的报错往往只说 Unexpected token,不告诉你哪一行有问题。这篇文章把常见错误拆开,并说明格式化工具到底对数据做了什么。

五个最常见的 JSON 错误

  • 尾逗号:{"a": 1,} 在 JavaScript 里合法,在 JSON 里不合法。数组最后一个元素后面也不能有逗号。
  • 单引号:JSON 的字符串和键名必须使用双引号,{'a': 1} 会直接报错。
  • 注释:JSON 标准不支持 // 或 /* */。需要注释时,很多配置格式会改用 JSON5、JSONC 或 YAML。
  • 未转义的控制字符:字符串里不能直接换行,必须写成 \n;反斜杠和双引号也要转义。
  • BOM 或不可见字符:从 Excel、微信或某些编辑器复制出来的内容,开头可能带 UTF-8 BOM,解析器会把它当作非法字符。

遇到报错时,先把内容粘贴到 JSON 格式化工具,它会给出出错的行列位置。如果位置指向文件末尾,通常意味着前面少了右括号或引号。

格式化改变了什么

格式化只调整空白:缩进、换行和空格。字段名、字段值、数组顺序都不会改变。压缩则是把所有不必要的空白去掉,适合放进请求体或环境变量。

「按键排序」是唯一会改变结构顺序的操作,它递归排序对象的键,数组顺序保持不变。排序后的 JSON 更适合做 diff 或计算签名,但不要在不了解下游依赖时随手排序。

大整数会丢精度

JavaScript 的 JSON.parse 会把数字转成双精度浮点数,超过 2^53 - 1 的整数无法精确表示。比如订单号 9007199254740993 经过解析再序列化,可能变成 9007199254740992。

如果数据里包含雪花 ID、超长订单号或金融金额,不要用「解析后再格式化」的链路处理。让后端以字符串返回,或使用支持大数保留的解析器。工具在检测到 16 位以上的整数时会给出提醒,但无法替你做业务层面的决定。

大文件与敏感数据

几 MB 的 JSON 在浏览器里处理没有问题;几十 MB 的文件会让页面明显卡顿,因为解析和渲染都发生在主线程。更大的文件建议用命令行工具,例如 jq:

jq . payload.json > pretty.json
jq -c . payload.json > minified.json

接口返回里经常带 token、手机号和地址。使用在线工具时,优先选择在本地处理、不上传内容的实现;本站的 JSON 工具不会发送网络请求,但截图、录屏和浏览器插件仍然可能泄露数据。

一个够用的检查流程

  1. 先点「仅校验」,确认语法没有问题。
  2. 格式化后看结构是否符合预期,特别注意数组和对象的层级。
  3. 需要放进请求体时再压缩,避免把带缩进的版本直接发出去。
  4. 涉及签名时,确认双方使用相同的键顺序和空白规则。

把这些步骤固定下来,比每次出错后凭感觉改标点更可靠。

Toolbox 编辑部

关注在线工具、图片处理与本地优先的软件。