node-heap-oom

Node.js 堆内存溢出

现象

Node.js 进程被 OOM Killer 终止，或抛出 JavaScript heap out of memory；接口延迟升高、GC 频繁，容器内存接近 limit。

快速定位

node --max-old-space-size=4096 app.js
node --inspect=0.0.0.0:9229 app.js

抓取堆快照：

kill -USR2 <PID>
# 或使用 inspector
node -e "require('v8').writeHeapSnapshot('/tmp/heap.heapsnapshot')"

查看容器内存：

cat /sys/fs/cgroup/memory.max
cat /sys/fs/cgroup/memory.current

常见根因

• 缓存/Map 无上限，对象长期不释放。
• 事件监听器或定时器未清理，导致闭包泄漏。
• 大文件/大 JSON 一次性读入内存。
• 并发请求过多，峰值内存超过限制。
• 堆上限设置高于容器 limit，被 OOM Killer 终止。
• 第三方库泄漏或 native 内存增长。

修复

• 用 Chrome DevTools 加载 heap snapshot，对比对象增长。
• 给缓存设置上限和 TTL。
• 流式处理大文件，避免一次性 buffer。
• 限制并发和请求体大小。
• 设置 --max-old-space-size 小于容器 limit，预留 native 内存。
• 增加内存和 GC 监控，定位泄漏后再扩容。

相关命令

• node — 堆参数和 inspector
• chrome-devtools — 分析 heap snapshot
• pm2 — 进程管理和内存监控
• ss / top — 连接和资源排查