🚨 JSON.stringify 的 6 个隐藏坑:为什么你的数据序列化后"消失"了?

问题场景

后端同学甩来一句:"你传的 status 字段丢了,整个对象都是 null。" 你打开 DevTools 一查,明明打印出来是有值的。更诡异的是,同一个对象存 localStorage,刷新后有些字段直接不见了。

十有八九,你踩中了 JSON.stringify 的隐藏坑。

原因分析

JSON.stringify 不是"把对象变成 JSON 字符串"这么简单,它内部有一套序列化规则,很多值会被静默忽略 或偷偷转换,不报错、不警告,数据就这样无声无息地丢了。

6 个隐藏坑详解

坑 1:undefined / 函数 / Symbol 被静默丢弃

js 复制代码
const obj = {
  name: 'xuange',
  age: undefined,        // ❌ 被丢弃
  sayHi() {},            // ❌ 被丢弃
  [Symbol('id')]: 1,     // ❌ 被丢弃
  extra: null            // ✅ null 会被保留
};
JSON.stringify(obj); // '{"name":"xuange","extra":null}'

关键区别:对象属性 里的 undefined/函数/Symbol 整个键被丢弃;但数组元素 里的它们会变成 null:

js 复制代码
JSON.stringify([undefined, function(){}, 1]); // '[null,null,1]'

坑 2:NaN / Infinity 悄悄变成 null

js 复制代码
JSON.stringify({ a: NaN, b: Infinity, c: -Infinity });
// '{"a":null,"b":null,"c":null}'  --- 数值语义完全丢失

如果后端按 number 类型强校验,这里就是线上事故的源头。

坑 3:循环引用直接抛错

js 复制代码
const a = {}; a.self = a;
JSON.stringify(a); // ❌ TypeError: Converting circular structure to JSON

常见于:Vue 响应式对象(__ob__ 循环)、树形结构带 parent 指针。解决:用 replacer 过滤或维护一个 WeakSet 记录已访问对象。

坑 4:Date 不是"对象",是字符串

js 复制代码
JSON.stringify({ time: new Date() });
// '{"time":"2026-08-08T02:00:00.000Z"}' --- 自动调用了 toJSON()

序列化后时区信息丢失,跨时区后端解析容易差 8 小时。

坑 5:大数精度丢失

js 复制代码
JSON.stringify({ id: 9007199254740993 }); // '{"id":9007199254740992}'

超过 Number.MAX_SAFE_INTEGER(2^53-1)的整数会静默丢精度。雪花 ID、微信订单号都容易中招,必须用字符串传输。

坑 6:toJSON 的"越权"

只要对象上有 toJSON 方法,序列化结果就由它说了算,其他属性全部作废:

js 复制代码
const user = { name: '轩哥', toJSON() { return { name: '匿名' }; } };
JSON.stringify(user); // '{"name":"匿名"}'

解决方案:万能安全序列化

js 复制代码
function safeStringify(value, space) {
  const seen = new WeakSet();
  return JSON.stringify(value, (key, val) => {
    if (typeof val === 'bigint') return val.toString();      // 大数转字符串
    if (val instanceof Date) return val.toISOString();       // 明确时区
    if (typeof val === 'function' || typeof val === 'symbol') return undefined;
    if (typeof val === 'object' && val !== null) {
      if (seen.has(val)) return '[Circular]';                // 防循环引用
      seen.add(val);
    }
    return val;
  }, space);
}

业务侧约定:ID 一律字符串、时间统一 ISO 格式、可选字段用 null 不用 undefined,从源头消灭歧义。

要点总结

  • undefined/函数/Symbol 在对象里被丢弃、在数组里变 null,NaN/Infinity 变 null
  • 循环引用抛错,WeakSet + replacer 可兜底
  • Date 自动转 ISO 字符串、大整数丢精度 → 用字符串传输
  • 有 toJSON 时其他属性全失效,这是"特性"也是"坑"
  • 生产环境建议封装 safeStringify 统一处理边界值
相关推荐
parade岁月6 小时前
SolidJS 2.0 正式发布:异步成为响应式的一部分
前端
lcy_246 小时前
防抖节流、并发控制、指数退避重试——我把它收进了一个库 async-concurrency-kit
前端
程序员大阳6 小时前
副队长Vue3教程(5)--事件绑定 v-on
前端·javascript·vue.js·vue3·事件绑定·v-on
艾莉丝努力练剑6 小时前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
泯泷7 小时前
Vercel AI SDK 6 完整教程系列 - 第二部分:结构化数据与工具调用
前端·javascript
OpenTiny社区8 小时前
我用Vue 100%复制DeepSeek开源的网页App,代码更少,功能还更多!
前端·vue.js·github
MyBili8 小时前
Chrome开发者工具入门:从看懂页面到高效调试
前端·chrome·谷歌浏览器·开发工具·chrome devtools·网页调式·网络请求分析
云起SAAS8 小时前
手机靓号选号商城H5源码 完整前后台可直接运行
前端·javascript·后端
code2cat9 小时前
JavaScript编程篇之异步请求:切换到待办,为什么又显示了全部任务
前端·javascript
Moment9 小时前
RSI 是怎样让 AI 改进自己的 ❓❓❓
前端·后端·面试