JSON 处理最佳实践：校验、修复与常见报错

JSON 是接口与配置的事实标准，也是日常报错的高发区。本文汇总处理 JSON 时的高频问题：成因、修复方式与预防实践，全部可在 本站 JSON 工具中直接实操。

一、三大类高频报错

1. 尾随逗号

{"a": 1,} 在 JavaScript 对象字面量里合法，但在 JSON 里非法（RFC 8259 不允许）。常见于从 JS 代码复制对象、或手工增删字段后忘了清理。修复：删除最后一个成员后的逗号。

2. 键未加双引号

{name: "alice"} 同样是 JS 语法而非 JSON。JSON 的键必须是双引号包裹的字符串，单引号也不行。

3. 转义与编码错误

字符串中的双引号必须写成 \"；从日志或代码里复制出来的 JSON 常带整体包裹引号或拼接痕迹，导致 Unexpected token。本站工具的「智能修复」可以自动处理尾随逗号、整体引号包裹、缺少引号/逗号等常见问题。

二、格式化与校验的正确姿势

• 先校验再解析：拿到外部 JSON 先过一遍校验，比让程序在运行时抛异常更容易定位问题行；
• 缩进统一：2 或 4 空格均可，但团队内要一致，diff 才干净；
• 压缩用于传输、格式化用于阅读：日志与配置文件保留格式化版本，接口响应可压缩。

三、Unicode 转义与中文

部分序列化器（如 Java 默认的 Jackson 配置、老版本 PHP json_encode）会把中文输出为 \uXXXX 转义。这在语法上合法、语义上等价，但可读性为零，也影响关键字搜索。排查接口返回时可用 Unicode 转中文功能还原。注意：转义只影响展示，不影响程序解析，不要为此修改生产序列化配置。

四、JSON 与 GET 查询参数

把小 JSON 结构编码进 URL 传递（如看板跳转携带过滤条件）时，标准做法是 encodeURIComponent(JSON.stringify(obj))，接收方反向操作。直接拼接未编码的 JSON 会因 {、"、空格等字符破坏 URL 结构。本站 JSON 工具提供一键转换，可先用 URL 编码工具对照验证。

五、隐私提醒

排查报错时粘贴的往往是真实业务数据。服务端处理的在线工具会看到全部内容，本地处理的工具不会。本站 JSON 工具的校验、格式化与修复全部在浏览器完成，断网可用，适合处理生产报文。