# JSON 验证：什么才算有效，以及如何读懂错误

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

- Tool: [JSON 校验器](https://toolsg.com/zh/json-validator)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 检查内容 | 仅语法，使用浏览器的 JSON.parse — 不检查模式（schema）、类型和必填字段。 | [IETF — RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.html) |
| 顶层值 | 任何 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 格式化](https://toolsg.com/zh/json-formatter)美化，用 [JSON 压缩工具](https://toolsg.com/zh/json-minify)缩小，用 [JSON 查看器](https://toolsg.com/zh/json-viewer)浏览有效数据，或用 [JWT 过期检查器](https://toolsg.com/zh/jwt-expiration-checker)检查令牌。

## 常见问题

**如何找到 JSON 中的错误？**

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

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

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

**为什么提示我的 JSON 无效？**

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

**它会改动我的数据吗？**

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

**能处理大型文档吗？**

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


## 资料来源

- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — Grammar, top-level values, duplicate names.
- [ECMA-404 — The JSON data interchange syntax](https://ecma-international.org/publications-and-standards/standards/ecma-404/)
- [MDN — JSON.parse()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse)
