JSON 本身不支持 Buffer 类型，JSON.stringify() 会将其转为 {type: 'Buffer', data: [...]} 形式，而 JSON.parse() 默认无法自动还原。需借助 reviver 函数，在解析时识别并重建 Buffer 实例，才能恢复 .toString() 的正确行为。
json 本身不支持 buffer 类型，`json.stringify()` 会将其转为 `{type: 'buffer', data: [...]}` 形式，而 `json.parse()` 默认无法自动还原。需借助 `reviver` 函数，在解析时识别并重建 buffer 实例，才能恢复 `.tostring()` 的正确行为。
当使用 JSON.stringify() 序列化包含 Buffer 的对象时，Node.js 会自动调用其内置的 .toJSON() 方法，将 Buffer 转换为形如 { type: 'Buffer', data: [67, 97, ...] } 的普通对象——这是标准且安全的序列化方式，但代价是丢失类型信息。若直接 JSON.parse()，得到的只是普通对象，调用 .toString() 会返回 [object Object]，而非原始字符串内容。
解决的关键在于：在 JSON.parse() 中传入自定义 reviver 函数，对符合 Buffer 序列化结构的对象进行智能重建。
以下是一个健壮、可扩展的 reviver 实现：
const reviver = (key, value) => {
// 非对象值直接返回
if (typeof value !== 'object' || value === null) return value;
const keys = Object.keys(value);
// 仅处理恰好含 'type' 和 'data' 两个属性的对象（Buffer.toJSON() 标准格式）
if (keys.length !== 2 || !keys.includes('type') || !keys.includes('data')) {
return value;
}
const { type, data } = value;
// 检查全局作用域是否存在该构造器，且其原型有 toJSON 方法（确保是标准可序列化类）
const Constructor = globalThis[type];
if (!Constructor || typeof Constructor.prototype?.toJSON !== 'function') {
return value;
}
try {
// 优先使用预定义还原逻辑（如 Buffer.from 替代已废弃的 new Buffer）
if (type === 'Buffer') {
return Buffer.from(data);
}
// 可按需扩展其他类型，例如 Uint8Array:
// if (type === 'Uint8Array') return new Uint8Array(data);
// 默认兜底：new Constructor(data)
return new Constructor(data);
} catch {
return value; // 构造失败则保持原样，避免解析中断
}
};
使用方式只需一行修改：
const buf = Buffer.from('Calling Mr. Jones', 'utf8');
const ob = { b: buf };
const obS = JSON.stringify(ob);
const obExtracted = JSON.parse(obS, reviver); // ✅ 注入 reviver
console.log(obExtracted.b.toString()); // 输出 "Calling Mr. Jones" —— 正确！
console.log(obExtracted.b instanceof Buffer); // true
⚠️ 注意事项：
- reviver 是深度遍历的，它会接收每一个键值对（包括嵌套对象），因此判断逻辑必须严谨，避免误还原非 Buffer 对象；
- 不要依赖 new Buffer(data)（已弃用且存在安全风险），始终使用 Buffer.from(data)；
- 若数据可能包含其他类数组类型（如 TypedArray、DataView），可在 revivers 映射中补充对应处理逻辑；
- 在浏览器环境中，globalThis 等价于 window；在 Node.js 中为 global，该写法具备跨环境兼容性。
总结：JSON 是纯数据交换格式，不保留类型语义。要实现 Buffer 的无损往返，必须在反序列化阶段主动介入——reviver 函数正是为此设计的标准机制。合理封装该逻辑后，即可在配置传输、本地存储等场景中安全地持久化二进制数据。
