你的JSON在欺骗你

Lobsters Hottest 新闻

摘要

本文解释了JavaScript中JSON序列化如何悄悄改变数据:大整数失去精度,undefined属性消失,Date变成字符串,NaN变成null。文章追溯了JSON的历史,并主张开发者应定义明确的传输格式,以避免意外的数据契约。

<p><a href="https://lobste.rs/s/tjgemj/your_json_is_lying_you">评论</a></p>
查看原文
查看缓存全文

缓存时间: 2026/08/03 03:29

# 你的 JSON 在欺骗你 来源:https://blog.gaborkoos.com/posts/2026-08-03-Your-JSON-Is-Lying-to-You/ 在浏览器控制台中运行这段代码: `` const payload = { id: 9007199254740993 } console.log(JSON.stringify(payload)) // {"id":9007199254740992} `` 值以`3`结尾,但序列化结果以`2`结尾。没有任何异常抛出,输出仍然是有效的 JSON,所以当该值是一个埋藏在更大载荷中的标识符时,这种变化很容易被忽略。 现在试试一个更复杂的对象: `` 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 // } `` 数字变了,`missing`属性消失了,`Date`变成了字符串,`NaN`变成了`null`。这个对象经历了 JavaScript 中最常见的序列化往返,但复制后的对象已不再携带与原始对象相同的数据或类型。 ## 我们是如何走到这一步的 (https://blog.gaborkoos.com/posts/2026-08-03-Your-JSON-Is-Lying-to-You/#how-we-got-here) JSON 大约在 2001 年出现,作为一种在浏览器和服务器之间交换结构化数据的轻量级方式。Douglas Crockford 命名并推广了这种格式,RFC 4627 (https://www.rfc-editor.org/rfc/rfc4627) 在 2006 年对其进行了正式规范。当前标准是 RFC 8259 (https://www.rfc-editor.org/rfc/rfc8259),发布于 2017 年。 当时,XML 主导着 Web 上的数据交换。JSON 提供了一种基于 JavaScript 开发者已经从对象和数组字面量中认知的语法、体积更小的文法。JSON 文档几乎不需要什么机制就能生成和消费,这使它非常适合 2000 年代初日益交互的 Web 应用。 这种小巧的文法至今仍是 JSON 吸引力的来源。它支持字符串、数字、布尔值、`null`、数组和对象,为不同语言提供了一种公共表示,而无需引入某一种语言的完整类型系统。它的设计更倾向于一种最小化、可移植的线上格式,而不是精确保留 JavaScript 中可用的每一个值。 JavaScript 包含许多该模型之外的值。它有`undefined`、`BigInt`、符号、特殊数值、带原型对象、以及具有自身内部状态的内置集合。`JSON.stringify` 必须改变或拒绝该格式无法表示的值,而`JSON.parse` 接收到的信息又太少,无法重建大多数原始类型。 当一个值离开创建它的进程时,这些差异就会变得可见。将其写入缓存或数据库、发送给另一个服务、或在另一种语言中读取,都可能暴露出那些在 JavaScript 中一直隐藏的假设。JSON 本身可以保持完全有效,而含义在传递过程中已经改变。 本文探讨了这些变化,并解释了如何定义一种能够保留你的应用实际所需信息的线上表示。目标是让 JSON 边界变得明确,使一种便捷的编码不会悄悄变成一种意外的数据契约。 ## 数字可能在 JSON 看到它之前就已经出错了 (https://blog.gaborkoos.com/posts/2026-08-03-Your-JSON-Is-Lying-to-You/#the-number-may-be-wrong-before-json-sees-it) 开头的示例在序列化过程中揭示了改变后的值,但精度丢失发生得更早。JavaScript 在计算数字字面量时就已经将`9007199254740993` 四舍五入了,远在`JSON.stringify` 接收到它之前。 `` const id = 9007199254740993 console.log(id) // 9007199254740992 `` JavaScript 使用 ECMAScript 的 `Number` 类型 (https://tc39.es/ecma262/#sec-ecmascript-language-types-number-type) 所描述的 IEEE 754 binary64 格式来存储普通数字。这种格式可以精确表示从`Number.MIN_SAFE_INTEGER` 到`Number.MAX_SAFE_INTEGER` 的整数,即`-(2^53 - 1)` 到`2^53 - 1`。超出该范围后,相邻的整数可能映射到相同的存储值。 JSON 有不同的约定:数字文法 (https://www.rfc-editor.org/rfc/rfc8259#section-6) 描述了数字如何以十进制文本形式书写,但没有为每种实现规定一种内存中的数字类型。因此,一个具有更宽整数类型的系统可以生成包含 JavaScript 无法精确存储的值的合法 JSON。 `` 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" `` 模式必须说明`id` 是一个十进制字符串,而不是普通数字。接收程序可以将其保留为标识符,或者在进行算术运算时转换为`BigInt`。只要生产者和消费者显式约定,其他编码方式也可以使用。 ## `undefined` 可以有多种含义 (https://blog.gaborkoos.com/posts/2026-08-03-Your-JSON-Is-Lying-to-You/#undefined-can-mean-multiple-things) 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 `` 这种区别在应用代码中可能很重要。缺失属性可能意味着没有请求任何更新,而存在属性可能意味着调用方提供了一个仍需解释的值(虽然你可以争论这不是好的应用设计)。当包含`undefined` 的对象属性被序列化时,这种区别就消失了。 `` const value = { name: 'Alice', nickname: undefined } const json = JSON.stringify(value) console.log(json) // {"name":"Alice"} const copy = JSON.parse(json) console.log('nickname' in copy) // false `` JSON 没有`undefined` 值,所以`JSON.stringify` 会省略该属性。这种行为对于普通响应载荷来说通常看起来合理,但它可能会改变部分更新、配置覆盖、表单提交和缓存状态的含义。 考虑一个使用`null` 来清除昵称、使用省略来保持昵称不变的端点: `` const leaveUnchanged = {} const clearNickname = { nickname: null } const ambiguousUpdate = { nickname: undefined } console.log(JSON.stringify(leaveUnchanged)) // {} console.log(JSON.stringify(clearNickname)) // {"nickname":null} console.log(JSON.stringify(ambiguousUpdate)) // {} `` 第一个和第三个对象在 JavaScript 中本来可以区分,却变成了相同的 JSON。一旦序列化,接收方就无法确定该属性是一开始就不存在,还是因为其值为`undefined` 而被移除。 数组遵循不同的规则。移除一个数组元素会导致后面每个位置发生偏移,所以不受支持的值会变成`null`。 `` const values = ['first', undefined, 'third'] console.log(JSON.stringify(values)) // ["first",null,"third"] `` 在顶层,`JSON.stringify(undefined)` 产生 JavaScript 的`undefined`。它不会返回 JSON 文本,这在代码假设每次成功调用都返回字符串时可能会令人意外。 `` const result = JSON.stringify(undefined) console.log(result) // undefined console.log(typeof result) // "undefined" `` 函数和符号遵循同样的上下文相关模式。它们在对象中被省略,在数组中被转换为`null`,而顶层序列化则返回`undefined`。 `` const fn = () => 42 console.log(JSON.stringify({ fn })) // {} console.log(JSON.stringify([fn])) // [null] `` API 契约应该直接定义省略和`null`,因为 JSON 只能携带这两种状态。如果 JavaScript 代码需要额外的状态,它必须在序列化之前显式编码该状态,而不是依赖`undefined` 来撑过这次往返。 ## 对象顺序能撑到穿过边界之前 (https://blog.gaborkoos.com/posts/2026-08-03-Your-JSON-Is-Lying-to-You/#object-order-survives-until-it-crosses-a-boundary) 现代 JavaScript 为`JSON.stringify` 提供了稳定的属性顺序。只要对象本身不改变,序列化同一个普通对象会反复产生相同的键序列。 `` const value = { z: 1, a: 2, m: 3 } console.log(JSON.stringify(value)) // {"z":1,"a":2,"m":3} `` 这一行为由 ECMAScript 定义。`JSON.stringify` (https://tc39.es/ecma262/#sec-json.stringify) 使用与`Object.keys()` 相同的稳定排序规则来访问可枚举的、字符串键的自身属性。整数索引键首先按升序排列,然后是其他按创建顺序排列的字符串键。 `` const value = {} value.b = 'second' value[10] = 'ten' value[2] = 'two' value.a = 'first' console.log(JSON.stringify(value)) // {"2":"two","10":"ten","b":"second","a":"first"} `` 结果在 JavaScript 内部是可预测的,但 JSON 给对象成员赋予了一个更弱的含义。RFC 8259 将对象定义为无序集合 (https://www.rfc-editor.org/rfc/rfc8259#section-4),并指出解析库在是否向调用代码暴露成员顺序方面各不相同。 一个 JavaScript 服务可能会发送以下文档。它的文本顺序是可见的,这可能让顺序看起来像是契约的一部分: `` {"z":1,"a":2,"m":3} `` 一个 Go 服务可以将该对象解码为`map[string]any`。Go 语言规范 (https://go.dev/ref/spec#For_statements) 没有规定 map 的迭代顺序,所以遍历解码后的 map 的代码不能依赖按原顺序接收`z`、`a` 和`m`。另一个解析器或序列化器也可能在保留相同 JSON 对象的同时暴露不同的顺序。 当应用赋予位置一种数据模型并不承载的意义时,这一点就很重要。工作流可能将第一个属性视为最高优先级,或者测试可能比较原始 JSON 字符串,即使它们的对象包含相同的成员。这两种设计都依赖一种顺序保证,而这种保证在另一个运行时处理该文档时可能消失。 当顺序承载含义时,请用数组来表示它。这样序列就成为了数据模型的一部分: `` [ {"name":"z","value":1}, {"name":"a","value":2}, {"name":"m","value":3} ] `` 数组由 JSON 规范规定为有序的,所以每个合规的解析器都会保留序列。额外的结构使预期的契约对读者和实现都变得可见。 哈希、签名、缓存键和内容寻址标识符需要单独的解决方案。两个 JSON 文本可以表示同一个对象,但属性顺序或空白字符不同,从而产生不同的字节序列。 `` const first = '{"a":1,"b":2}' const second = '{ "b": 2, "a": 1 }' console.log(JSON.parse(first)) // { a: 1, b: 2 } console.log(JSON.parse(second)) // { b: 2, a: 1 } console.log(first === second) // false `` 对 JSON 进行签名或哈希的系统在计算字节之前需要一种约定的规范化表示。`JSON.stringify` 在接收具有相同属性顺序的同一个对象时会产生可重复的输出,但两个具有相同成员的对象如果这些属性以不同顺序创建,仍然可能产生不同的字符串。规范化方案为等价数据定义一种表示,独立于每个生产者如何构建它。 ## JSON 会抹掉类型 (https://blog.gaborkoos.com/posts/2026-08-03-Your-JSON-Is-Lying-to-You/#json-erases-types) JSON 文档的类型系统比 JavaScript 小。适合其模型的值可以直接穿越边界,而其他值必须被转换成 JSON 可以表示的东西。结果文档携带的是转换后的值,而没有记录其原始的 JavaScript 类型。 `Date` 是一个常见的例子。在序列化过程中,一个有效的`Date` 会通过其`toJSON()` 方法生成一个 ISO 时间戳字符串。 `` const createdAt = new Date('2026-07-21T12:00:00Z') const json = JSON.stringify({ createdAt }) console.log(json) // {"createdAt":"2026-07-21T12:00:00.000Z"} `` JSON 中包含的是一个普通字符串。当它被解析时,没有任何类型标记告诉 JavaScript 这个值来自`Date`。 `` const copy = JSON.parse(json) console.log(typeof copy.createdAt) // "string" console.log(copy.createdAt instanceof Date) // false `` 这种歧义使得`JSON.parse` 无法自动恢复该类型。一个看起来像时间戳的值可能是从一个`Date` 转化来的,也可能从一开始就是一个字符串。将每个匹配的字符串都转换为`Date` 会改变合法的文本,并引入另一种数据错误。 序列化还会移除原始的时区上下文。一个`Date` 存储的是一个时刻,并以 UTC 输出,因此像`-04:00` 这样的输入偏移量无法在这次转换中保留。 `` const scheduledAt = new Date('2026-07-21T09:00:00-04:00') console.log(JSON.stringify({ scheduledAt })) // {"scheduledAt":"2026-07-21T13:00:00.000Z"} `` 时刻保持不变,但原始的挂钟时间和偏移已经消失了。你的 JS Date 在欺骗你 (https://blog.gaborkoos.com/posts/2026-07-21-Your-JS-Date-Is-Lying-to-You/) 更详细地介绍了日期和时区意图的丢失。 其他内置类型会丢失更多信息。`Map`、`Set`、`RegExp` 和`Error` 将其有意义的状态存储在内部或不可枚举属性中,所以它们的默认 JSON 表示是空对象。 `` const original = { tags: new Set(['json', 'js']), lookup: new Map([['answer', 42]]), pattern: /json/i, error: new Error('failed') } const copy = JSON.parse(JSON.stringify(original)) console.log(copy) // { tags: {}, lookup: {}, pattern: {}, error: {} } `` 结果中没有任何东西能标识每个空对象的原始类型。它们的内容也已经被丢弃,所以接收方无法仅凭 JSON 重建它们。 特殊的数值遵循另一种转换规则。JSON 数字无法表示`NaN` 或无穷大的任意一种符号,所以`JSON.stringify` 会为它们写入`null`。 `` const measurements = { current: NaN, upper: Infinity, lower: -Infinity } console.log(JSON.stringify(measurements)) // {"current":null,"upper":null,"lower":null} `` 这种转换尤其容易被忽略,因为`null` 是有效的 JSON,而且解析会成功。下游代码再也无法区分“不可用的测量值”和“产生`NaN` 的计算”,或“由无穷大表示的无界值”。 类型化数组保留其索引值,但丢失了类型和二进制解释。它们的可枚举索引会变成普通对象属性。 `` const bytes = new Uint8Array

相似文章

Go JSON v2 迁移:Go 1.27 中有哪些破坏性变化

Lobsters Hottest

Go 1.27 在标准库中引入了 `encoding/json/v2`,并悄悄在它之上重新实现了旧的 `encoding/json` 包,从而改变了错误信息字符串,并调整了默认行为:nil 切片变为 `[]`、字段匹配改为大小写敏感、拒绝重复的 key,以及在直接导入 v2 时 `time.Duration` 不再进行序列化。

关于NaN的两个案例分析

Lobsters Hottest

本文探讨了NaN在Python和Lua中的两种意外行为,其中对相等性和比较的隐含假设导致了令人惊讶的结果,例如Python列表相等性忽略了NaN的自不等性,以及Lua的for循环将NaN作为步长或限制时处理不当。

JSON5E - 人类友好的JSON5

Lobsters Hottest

libpdjson5 是一个公共领域的 C 语言库,用于解析 JSON、JSON5 和 JSON5E,具有完整的 Unicode 支持、极小的内存占用和流式 API。它是 pdjson 的一个分支,进行了多项改进,包括对 JSON5E 的支持。