JSON 校验器

检查 JSON 是否有效,并准确定位出错位置。

JSON 有效。

所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。

深度指南

JSON 验证:什么才算有效,以及如何读懂错误

验证器检查什么(仅 RFC 8259 语法)、有意接受什么、行列位置如何报告,以及常见错误与 Chrome 系引擎给出的信息对照表。

最后核实: 资料来源: IETF — RFC 8259 本指南的纯文本版

关键数字一览

检查内容
仅语法,使用浏览器的 JSON.parse
不检查模式(schema)、类型和必填字段。
来源: IETF — RFC 8259
顶层值
任何 JSON 值都有效
5、"text"、null、[] 和 {} 都能通过;RFC 8259 把 JSON 文本定义为一个序列化的值。
重复键
接受
语法允许;RFC 8259 只说名称应当(SHOULD)唯一,否则行为不可预测。
错误位置
浏览器信息中含位置时才会报告
有些信息(例如逗号后出现意外标记)不带位置,因此无法显示行和列。

这里的“有效”是什么意思

验证器对你粘贴的内容执行 JSON.parse,显示绿色的“JSON 有效”横幅或红色的错误信息,并随输入实时更新。输入为空或只有空白时不显示任何内容。一切都在页面本地完成。

因此“有效”只表示“文本符合 JSON 语法”,仅此而已。它不会告诉你数据是否包含 API 需要的字段(那需要模式验证器)、数字是否能放进 64 位整数,或键是否唯一。以下例子都能通过:

  • 5、"hello"、null、true:RFC 8259 允许顶层是任何值。
  • {"a":1,"a":2}:重复键符合语法。
  • {"a":"\ud800"}:浏览器接受孤立的代理项转义。
  • 1e999:语法上是数字,尽管 JavaScript 双精度放不下。
  • 开头和结尾的空白或空行。

读懂信息

页面会输出 JSON 无效:<浏览器信息>。如果信息含有 position N 但没有行号,工具会根据文本计算并附加“(第 L 行,第 C 列)”。目前的 Chrome 系引擎在信息里已含“(line 1 column 8)”,所以不会重复添加;有些引擎只给字符偏移量,页面会把它换算成行列。两者都没有的信息(例如 Unexpected token ']', "[1,]" is not valid JSON)只显示出问题的标记和一段摘录。信息措辞出自浏览器本身,不会被翻译。

输入 典型信息(Chrome 系引擎)
{"a":1,} Expected double-quoted property name in JSON at position 7 (line 1 column 8)
{'a':1} Expected property name or '}' in JSON at position 1
{a:1} Expected property name or '}' in JSON at position 1
[1 2] Expected ',' or ']' after array element at position 3
{"a" 1} Expected ':' after property name at position 5
{"a":1}} Unexpected non-whitespace character after JSON at position 7
{"a":"x⏎y"}(原始换行) Bad control character in string literal at position 7
{"a":"\x41"} Bad escaped character
{"a":5.} Unterminated fractional number
{"a":-} No number after minus sign
[1,] Unexpected token ']'(无位置)
{"a":.5}、{"a":+1} Unexpected token(无位置):不允许以 . 或 + 开头
开头带 BOM 的 [1] 在不可见字符处出现 Unexpected token

高效排错

  1. 先去看报告的行和列;真正的错误通常就在那里或稍前。
  2. 查找常见元凶:末尾逗号、单引号、未加引号的键、注释、项目之间漏逗号、字符串内的原始换行。
  3. 如果位置指向最末尾,说明前面有括号或引号一直没有闭合。
  4. 如果第一个字符出问题但看上去正常,可能是字节顺序标记(BOM)或不换行空格(U+00A0),它们都不算 JSON 空白。JSON 空白只有空格、制表符、换行和回车。
  5. 每次只改一处,然后查看新信息;横幅会立即更新。

提示: 在这里通过的文档仍可能让其他使用方出错。其他语言的解析器可能拒绝孤立代理项、拒绝超出其整数范围的数字,或在遇到重复键时失败。关键场景请用你实际使用的解析器再测一遍。

常见错误

  • 粘贴 JavaScript 对象(键不加引号、单引号、注释)或 Python 的 True/None 却期望是 JSON。
  • 把“有效”当成“数据正确”:验证器不检查含义。
  • 把 JSON Lines 文件(每行一个对象)当作一个文档验证;第一个对象之后就会失败,请逐行验证。
  • 粘贴的是返回的 HTML 或登录页而不是 JSON;信息中会提到 < 是意外的标记。

相关工具

用 JSON 格式化美化,用 JSON 压缩工具缩小,用 JSON 查看器浏览有效数据,或用 JWT 过期检查器检查令牌。

常见问题

如何找到 JSON 中的错误?

输入框下方的结果会显示“有效 JSON”,或给出第一处错误的行号和列号,例如多余的逗号或单引号。

我的 JSON 会被发送到服务器吗?

不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时,这一点尤为重要。

为什么提示我的 JSON 无效?

最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。

它会改动我的数据吗?

不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。

能处理大型文档吗?

可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。

资料来源

  1. IETF — RFC 8259, The JSON Data Interchange Format — Grammar, top-level values, duplicate names.
  2. ECMA-404 — The JSON data interchange syntax
  3. MDN — JSON.parse()

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

相关工具