Node.js 怎么用 v8.writeHeapSnapshot 生成堆快照分析内存？

Question

仓乃文 · Accepted Answer

内存泄漏排查需要在代码运行时抓取堆内存快照，对比不同时间点的快照找出持续增长的对象。v8.writeHeapSnapshot() 在代码中直接生成 .heapsnapshot 文件，用 Chrome DevTools 加载分析，无需安装额外工具。生成堆快照： ```javascript const v8 = require("v8"); // 在代码中手动触发 const filename = v8.writeHeapSnapshot(); console.log("快照已保存:", filename); // 输出：快照已保存: Heap.20260508.123456.12345.0.001.heapsnapshot ``` 信号触发（生产环境安全）： ```javascript process.on("SIGUSR2", () => { const filename = v8.writeHeapSnapshot(); console.log("堆快照已生成:", filename); }); // 终端执行：kill -SIGUSR2 ``` 定时快照对比： ```javascript let snapshotCount = 0; setInterval(() => { snapshotCount++; if (snapshotCount <= 3) { const filename = v8.writeHeapSnapshot(); console.log(`快照 ${snapshotCount}:`, filename); } }, 60000); // 每分钟一个，共 3 个 ``` 补充说明： - 生成快照会暂停主线程，大堆可能暂停数秒 - 用 Chrome DevTools Memory 面板加载 .heapsnapshot 文件 - 对比两个快照：选择 Comparison 视图，找出新增对象 - 关注 Retained Size 大的对象，它是 GC 后能释放的内存 - Node.js 12+ 支持 --heapsnapshot-signal=SIGUSR2 启动参数自动生成