JSON 校验器
检查 JSON 是否有效,并准确定位出错位置。
JSON 有效。
所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。
深度指南
JSON 验证:什么才算有效,以及如何读懂错误
验证器检查什么(仅 RFC 8259 语法)、有意接受什么、行列位置如何报告,以及常见错误与 Chrome 系引擎给出的信息对照表。
关键数字一览
- 顶层值
- 任何 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 |
高效排错
- 先去看报告的行和列;真正的错误通常就在那里或稍前。
- 查找常见元凶:末尾逗号、单引号、未加引号的键、注释、项目之间漏逗号、字符串内的原始换行。
- 如果位置指向最末尾,说明前面有括号或引号一直没有闭合。
- 如果第一个字符出问题但看上去正常,可能是字节顺序标记(BOM)或不换行空格(U+00A0),它们都不算 JSON 空白。JSON 空白只有空格、制表符、换行和回车。
- 每次只改一处,然后查看新信息;横幅会立即更新。
提示: 在这里通过的文档仍可能让其他使用方出错。其他语言的解析器可能拒绝孤立代理项、拒绝超出其整数范围的数字,或在遇到重复键时失败。关键场景请用你实际使用的解析器再测一遍。
常见错误
- 粘贴 JavaScript 对象(键不加引号、单引号、注释)或 Python 的
True/None却期望是 JSON。 - 把“有效”当成“数据正确”:验证器不检查含义。
- 把 JSON Lines 文件(每行一个对象)当作一个文档验证;第一个对象之后就会失败,请逐行验证。
- 粘贴的是返回的 HTML 或登录页而不是 JSON;信息中会提到
<是意外的标记。
相关工具
用 JSON 格式化美化,用 JSON 压缩工具缩小,用 JSON 查看器浏览有效数据,或用 JWT 过期检查器检查令牌。
常见问题
如何找到 JSON 中的错误?
输入框下方的结果会显示“有效 JSON”,或给出第一处错误的行号和列号,例如多余的逗号或单引号。
我的 JSON 会被发送到服务器吗?
不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时,这一点尤为重要。
为什么提示我的 JSON 无效?
最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。
它会改动我的数据吗?
不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。
能处理大型文档吗?
可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。
资料来源
- IETF — RFC 8259, The JSON Data Interchange Format — Grammar, top-level values, duplicate names.
- ECMA-404 — The JSON data interchange syntax
- MDN — JSON.parse()
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。