
JavaScript 的 JSON 序列化会静默改变数据,文章解析其缺陷
来源标题:JSON Is Lying to You
JSON.stringify 与 JSON.parse 往返会静默丢失或改变数据:大整数精度丢失(9007199254740993 变成 ...992),undefined 属性消失,Date 变字符串,NaN 变 null。文章指出这一被广泛使用的序列化方式并不保证数据与类型保真,并回顾了 JSON 自 2001 年出现、2017 年 RFC 8259 定标准的历史。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
TLDR IT(2026-08-04)和 Javascript Weekly(2026-08-04)精选
const payload = { id: 9007199254740993 } console.log(JSON.stringify(payload)) // {"id":9007199254740992}
这个值以 3 结尾,但序列化结果却以 2 结尾。没有任何异常抛出,输出仍然是合法的 JSON,所以当这个值是一个埋在较大 payload 里的标识符时,这种变化很容易被忽略。
const original = { id: 9007199254740993, missing: undefined, createdAt: new Date('2026-07-21T12:00:00Z'), score: NaN const copy = JSON.parse(JSON.stringify(original)) console.log(copy) // { // id: 9007199254740992, // createdAt: "2026-07-21T12:00:00.000Z", // score: null // }
数字变了,缺失的属性消失了,Date 变成了字符串,NaN 变成了 null。这个对象经历了 JavaScript 中最常见的序列化往返,但副本携带的数据和类型已经和原对象不同了。
JSON 大约在 2001 年出现,作为一种在浏览器和服务器之间交换结构化数据的轻量方式。Douglas Crockford 为这种格式命名并推广了它,RFC 4627 在 2006 年对其进行了正式规范。当前标准是 2017 年发布的 RFC 8259。
当时,XML 在 Web 数据交换中占据主导地位。JSON 提供了一套小得多的语法,基于 JavaScript 开发者已经从对象和数组字面量中熟悉的语法。一份 JSON 文档可以用很少的机械工具来生成和读取,这使它天然适合 2000 年代初期日益交互化的 Web 应用。
这套小语法至今仍是 JSON 吸引力的来源。它支持字符串、数字、布尔值、null、数组和对象,为不同语言提供了一种共同的表示方式,而无需引入某一种语言的完整类型系统。它的设计倾向于一种极简且可移植的传输格式,而不是精确保留 JavaScript 中所有可能的值。
JavaScript 包含许多不在这个模型之内的值。它有 undefined、BigInt、symbol、特殊的数值、带原型的对象,以及带有自身内部状态的内置集合。JSON.stringify 必须修改或拒绝 JSON 格式无法表示的值,而 JSON.parse 收到的信息太少,无法重建大多数原始类型。
当值离开创建它的进程时,这些差异就会显现出来。把它写入缓存或数据库、发送给另一个服务,或用另一种语言读取,都可能暴露出在 JavaScript 中一直隐藏的假设。JSON 可以保持完全合法,而含义却在传递途中发生了变化。
本文探讨这些变化,并说明如何定义一种传输表示,以保留应用真正需要的信息。目标是让 JSON 的边界变得明确,以免一种便利的编码悄悄变成意外的数据契约。
开头的例子在序列化过程中暴露了变化后的值,但精度丢失发生得更早。JavaScript 在求值数字字面量时就把 9007199254740993 舍入了,那时 JSON.stringify 还没收到它。
const id = 9007199254740993 console.log(id) // 9007199254740992
JavaScript 使用 ECMAScript Number 类型所描述的 IEEE 754 binary64 格式来存储普通数字。这种格式可以精确表示从 Number.MIN_SAFE_INTEGER 到 Number.MAX_SAFE_INTEGER 的整数,即 -(2^53 - 1) 到 2^53 - 1。超出这个范围后,相邻的整数可能映射到同一个存储值。
JSON 有不同的契约:数字语法描述的是数字如何写成十进制文本,但它并不为每种实现规定统一的内存数值类型。因此,一个拥有更宽整数类型的系统可以生成合法的 JSON,其中包含 JavaScript 无法精确存储的值。
const text = '{"id":9007199254740993}' const parsed = JSON.parse(text) console.log(parsed.id) // 9007199254740992
这里文本仍然包含精确的整数。精度是在 JSON.parse 把该文本转换成 JavaScript Number 时丢失的。如果解析后的值之后再次被序列化,舍入后的结果就会成为发出数据的一部分。
这对数据库标识符、账号、发票总额以及以最小货币单位表示的金额都很重要。生产者可能发送了正确的数字,而接收方的 JavaScript 程序却悄悄存下了一个不同的数字。解析之后执行的校验无法恢复原始值,因为差异已经消失了。
BigInt 可以容纳超出安全 Number 范围的整数,但 JSON 没有对应的值类型。JavaScript 会拒绝转换,而不是自动选择一种编码。
const id = 9007199254740993n console.log(id) // 9007199254740993n JSON.stringify({ id }) // TypeError: Do not know how to serialize a BigInt
精确的整数在跨网络传输之前需要一种约定好的表示。十进制字符串通常是最简单的选择,因为 JSON 实现可以精确保留它的数字。
const json = JSON.stringify({ id: '9007199254740993' }) const parsed = JSON.parse(json) console.log(parsed.id) // "9007199254740993"
schema 必须声明 id 是十进制字符串,而不是普通数字。接收程序可以把它保留为标识符,或在需要算术运算时转换为 BigInt。其他编码方式也可以,只要生产者和消费者明确约定好即可。
JavaScript 区分缺失的属性和值为 undefined 的属性。直接读取两者都会得到 undefined,但属性检查能揭示差异:
const value = { present: undefined } console.log(value.present) // undefined console.log(value.missing) // undefined console.log('present' in value) // true console.log('missing' in value) // false
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。