JSON 格式化：常见错误与快速修复

JSON（JavaScript Object Notation）已成为 Web 与移动端最普遍的数据交换格式。其语法简洁、结构灵活，但看似简单的规则在实际工程中却常被忽略，导致接口失败、数据丢失或难以排查的线上问题。要实现稳定可靠的数据传递，需要对 JSON 的语法与工程实践形成系统化认知。

语法要点与边界

JSON 由对象（{}）、数组（[]）、值（字符串、数值、布尔、null、对象或数组）构成。键名必须为字符串并使用双引号，字符串使用双引号包裹并支持转义。

常见错误详解

• 尾随逗号：在对象或数组末尾添加多余逗号会导致解析失败。
• 未加引号的键名：键名省略双引号不符合标准。
• 错误的引号：使用单引号或不匹配的引号。
• 无效数值：如 NaN、Infinity、前导零的八进制形式。
• 转义问题：字符串中未正确转义双引号、反斜杠或特殊字符。
• 括号不匹配：复杂结构中容易出现对象或数组未闭合。

格式化与压缩（Pretty 与 Minify）

美化（Pretty-print）能提升可读性，便于调试与审查；压缩（Minify）用于生产传输以减少体积。二者应在构建或网关层自动化执行，避免人工失误。

超大 JSON 的工程策略

• 分页与分片：将大列表分页返回，降低单次负载。
• 流式传输：在某些场景使用流式 API 逐段传递。
• 压缩：结合 Gzip/Brotli 等传输层压缩。
• 延迟加载：前端对非首屏数据采用延迟或按需请求。

校验与契约：JSON Schema

为提升鲁棒性，可在接口层引入 JSON Schema 校验，约束数据类型、必填字段与结构形态，并在发布前进行契约测试。服务端与客户端共享契约可降低集成成本。

时间与数字的坑

日期推荐使用 ISO 8601 文本格式（如 2026-01-21T12:30:00Z）或 Unix 时间戳并声明单位。浮点数存在精度问题，金融场景建议文本或整数+精度表示。

安全与健壮性

• 拒绝循环引用：JSON 不支持循环引用。
• 大小限制：设置请求/响应体大小上限以防止异常流量。
• 错误处理：解析失败时返回明确的错误码与信息，便于快速定位。

调试清单

• 在本地或网关层统一进行格式化与校验。
• 引入契约测试，发布前验证请求与响应。
• 对超大数据采用分页或流式。
• 明确时间与数字的表达规范。

配套工具与工作流

开发过程中，可借助本站JSON 格式化工具进行美化、压缩与语法校验；对疑难问题结合单元测试与契约测试形成防线。

总结

JSON 的稳定交付依赖规范、工具与流程的共同作用。通过格式化、校验与契约化管理，再辅以对性能与安全的约束，能够显著降低线上隐患并提升协作效率。