Node.js 怎么检测和排查内存泄漏？

Question

仓乃文 · Accepted Answer

服务运行一段时间后内存持续增长不下降，最终 OOM 崩溃。Node.js 提供了多种工具检测内存泄漏：process.memoryUsage() 监控指标、v8.writeHeapSnapshot() 生成堆快照、--inspect 配合 Chrome DevTools 对比快照定位泄漏对象。

监控内存指标：
```javascript
setInterval(() => {
  const mem = process.memoryUsage();
  console.log({
    rss: `${(mem.rss / 1024 / 1024).toFixed(2)} MB`,
    heapUsed: `${(mem.heapUsed / 1024 / 1024).toFixed(2)} MB`,
    heapTotal: `${(mem.heapTotal / 1024 / 1024).toFixed(2)} MB`,
    external: `${(mem.external / 1024 / 1024).toFixed(2)} MB`
  });
}, 10000);
```

生成堆快照：
```javascript
const v8 = require("v8");
const fs = require("fs");

// 手动触发快照
v8.writeHeapSnapshot("heap-${Date.now()}.heapsnapshot");

// 信号触发（生产环境安全）
process.on("SIGUSR2", () => {
  const filename = v8.writeHeapSnapshot();
  console.log("堆快照已生成:", filename);
});
```

Chrome DevTools 对比快照：
```bash
node --inspect app.js
# 打开 chrome://inspect -> Memory -> Load 加载两个快照
# 对比视图找出持续增长的对象
```

补充说明：
- 常见泄漏原因：未移除的事件监听器、闭包引用、全局缓存无限增长
- rss 是进程总内存，heapUsed 是 V8 堆使用量，关注 heapUsed 更准确
- 生成快照会暂停主线程，生产环境用 SIGUSR2 信号触发
- --max-old-space-size 可以调大堆内存上限临时缓解
- node --heapsnapshot-signal=SIGUSR2 可以在 Node.js 12+ 自动生成快照