大对象转JSON瓶颈在于内存分配、循环引用、无效字段遍历和冗余数据，需通过提前剪枝与可控序列化优化：用WeakSet检测循环引用、白名单裁剪字段、分块流式写入、预处理扁平化结构。
大对象转 JSON 字符串的核心瓶颈不在 JSON.stringify 本身，而在于内存分配、循环引用、无效字段遍历和序列化冗余数据。高效处理的关键是“提前剪枝”和“可控序列化”，而非单纯优化调用方式。
避免循环引用导致崩溃或无限递归
大对象常含 DOM 节点、事件监听器、Map/Set 或手动构造的环状结构，直接 JSON.stringify(obj) 会抛 TypeError: Converting circular structure to JSON。
推荐用自定义 replacer 函数检测并跳过可疑引用：
const seen = new WeakSet();
const safeReplacer = (key, value) => {
if (typeof value === 'object' && value !== null) {
if (seen.has(value)) return '[Circular]';
seen.add(value);
}
return value;
};
JSON.stringify(largeObj, safeReplacer);
// 使用后记得 clear：seen.clear();
只序列化真正需要的字段（按需裁剪）
服务端返回的“大对象”往往含大量调试字段、缓存属性、私有前缀（如 _internal）、函数或 undefined 值——这些都不该进 JSON。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
建议显式定义白名单或过滤规则：
- 传入数组形式的
replacer：只保留关键键名，如JSON.stringify(obj, ['id', 'name', 'items']) - 用函数做细粒度控制：
value == null || typeof value === 'function'直接返回undefined（会被忽略） - 对嵌套数组/对象批量过滤：在
replacer中检查key === 'children'并截断深度超过 3 层的子树
分块序列化 + 流式写入（超大结构适用）
当对象体积达几 MB 以上，单次 JSON.stringify 会触发 V8 内存抖动，甚至 OOM。此时应放弃“一整块转字符串”，改用可中断、可流式输出的方式：
- 用 serialize-javascript（支持函数、正则，比原生更健壮）
- 对大型数组用
for循环 +JSON.stringify(item, replacer)拼接，配合setTimeout或queueMicrotask防卡 UI - Node.js 环境可用 stream-json 将对象逐字段转为 JSON Token 流，边序列化边写入文件或 HTTP 响应体
预处理：冻结无关属性 & 提前扁平化
某些“大”源于嵌套过深或重复结构（如树形数据每个节点都带完整父引用）。可在序列化前做轻量预处理：
- 用
Object.freeze()或Object.preventExtensions()防止意外属性注入（不影响性能，但提升确定性） - 将深层路径如
user.profile.address.city提前提取为city: user.profile.address.city，减少嵌套层级和 key 查找开销 - 把稀疏数组（
[,,1,,2]）转为对象映射{2: 1, 4: 2}，避免 JSON 序列化时生成大量null
