JSON 格式错误怎么查:从报错位置到最小样本

通过缺少引号、尾随逗号、括号不配对和类型错误的实际样本,逐步定位 JSON 问题。

JSON 报错通常不是“文件坏了”,而是某个字符不符合语法。最有效的方法不是盯着整份文件猜,而是保留原件、查看第一处报错位置、缩小到最小样本,再逐层恢复内容。

先看一个错误样本

下面内容包含两个常见问题:键名缺少双引号,最后一个字段后有多余逗号。

{
  "name": "示例商品",
  quantity: 3,
  "active": true,
}

把它复制到JSON 格式化与校验工具。先修复工具指出的第一处错误,把 quantity 改成带双引号的 "quantity";再次校验后再删除 true 后面的逗号。不要试图一次根据猜测修改十处,因为后续报错可能只是第一处语法错误造成的连锁反应。

四类高频问题

  1. JSON 的键和字符串使用双引号,不能用裸键或智能弯引号;
  2. 数组与对象的最后一项后通常不能保留逗号;
  3. 花括号与方括号必须成对,并符合对象和数组的层级;
  4. 数字、布尔值和 null 不加引号,字符串才加引号。语法正确不代表类型符合业务要求,例如带引号的 "3" 是字符串而不是数字。

大文件如何缩小范围

先复制报错行上下各十行,并补齐外层括号形成可测试片段。若仍无法定位,把数组项目减半测试,逐步确定是哪一项。修复后回到完整文件重新校验。可以用CSV 与 JSON 转换工具检查表格型数据,但嵌套对象在转换前要先决定如何展开。

隐私与安全

不要把真实 API Key、访问 Token、数据库密码或客户信息放进任何在线校验器。只需检查结构时,把值替换为示例字符串、0 或 false。AI 也可能给出看似正确但改变字段类型的修复,必须对照接口文档。

常见错误

  • 只看最后一条报错,没有先修第一处;
  • 用 JavaScript 对象写法代替严格 JSON;
  • 从聊天软件复制后混入弯引号和不可见字符;
  • 语法通过后就默认字段名、类型和必填项正确;
  • 格式化时覆盖原文件,没有保存备份。

适用范围与延伸

本方法适用于语法定位,不验证某个 API 的业务规则。接口仍可能要求特定字段、枚举或日期格式。需要理解数据格式选择可阅读CSV 与 JSON 分别适合什么场景,处理敏感样本前阅读使用在线工具处理文本和文件时,如何保护隐私

总结

保留原件,从第一处报错开始,缩小成最小样本,修复后再回完整文件检查。语法正确只是第一步,字段类型和业务约束还要单独核对。