开发实操 · 可复现示例
接口 JSON 报错:从语法检查到长整数保护
用三组接口数据定位尾随逗号、字符串转义和长整数精度问题,再通过格式化、类型草稿与文本对比核对修复结果。
由 DevTools 极客工具箱 维护 · 更新于
先判断:手里的是 JSON,还是 JavaScript 对象?
调试接口时,开发者工具中展开的对象并不一定是可直接粘贴的 JSON。JSON 的键名和字符串必须用双引号,不能写注释、undefined 或函数。定位问题前,尽量从 Network 面板复制原始响应,而不是复制控制台展示的对象。
例如下面这段配置有两个错误:键名没有双引号,而且最后一个字段后有尾随逗号。
{name: "demo", "enabled": true,}
修正后再放进 JSON 格式化工具:
{"name":"demo","enabled":true}
点击“格式化 (2空格)”应得到两行字段、保留 true 的布尔类型。若只是想缩短请求体,点击“压缩单行”即可;压缩并不修复语法错误。
不要用全局替换修复引号和逗号
看似方便的“把所有单引号替换成双引号”可能破坏原本合法的字符串。下面的英文撇号本来就是数据的一部分:
{"title":"developer's notes","text":"请保留 ,} 这两个字符"}
如果用正则直接删除“右大括号前的逗号”,第二个字段的内容也可能被修改。本工具使用严格解析,遇到非法 JSON 会显示错误,而不会悄悄重写输入。修复前保留原文,修复后用 文本对比 检查数据是否改变。
第二组:字符串中的换行必须转义
JSON 字符串不能包含未转义的实际换行。键值需要表达两行文本时,应写成 \n:
{"message":"第一行\n第二行"}
注意这和“整个 JSON 又被编码成字符串”不同。后者可能看起来像 "{\"ok\":true}",需要先还原外层字符串,再把结果作为 JSON 解析。每一层都应明确自己处理的是字符串还是对象,避免重复转义。
第三组:订单号为什么格式化后变了?
JavaScript 的安全整数上限是 9007199254740991。如果后端把更长的订单号作为数值发送,浏览器解析时就可能丢失精度。格式化无法找回丢掉的数字。
在后端接口允许调整时,应把标识符表示为字符串:
{"orderId":"9007199254740993","amount":19.5}
这个例子中,orderId 是标识符,amount 才是参与计算的数值。不要把所有数字机械转成字符串;应根据字段语义约定类型。金融金额等精度敏感字段还需要单独约定整数最小单位或十进制表示。
还有一个常见陷阱是重复键:{"status":1,"status":2} 解析后可能只剩后一个值。普通格式化结果不能证明原始响应没有重复字段,必要时应在源数据或专门的解析环节检查。
生成类型之后,仍要核对数据契约
“转 TypeScript”与“转 Go”适合生成草稿,不能替代接口 Schema。单个样本没有出现的可选字段、数组里混合的数据类型、可空值与特殊键名,都需要人工检查。将生成结果与服务端定义或 OpenAPI 文档对照,再用于代码库。
一条实用的检查顺序是:保存原文 → 严格校验 → 确认长数字和重复键 → 格式化 → 核对差异 → 复查类型草稿。每一步解决一个问题,比直接把“格式化成功”等同于“接口数据正确”更可靠。