Ubuntu环境下定位与修复JS内存泄漏的实用步骤
一 快速确认是否泄漏
- 观察系统层内存：用top/htop查看目标进程内存是否随时间单调上升且不回落；记录PID便于后续排查。
- 打印进程内存指标：在代码中定时输出process.memoryUsage()，关注heapUsed、rss的持续走高趋势。
- 接入运行时调试：以node --inspect启动应用，打开chrome://inspect连接，为后续堆快照与性能分析做准备。
- 辅助监控：使用PM2观察内存曲线，或在压力/回归测试中复现问题，确认泄漏可稳定触发。
二 抓取并分析堆快照
- 方式A（开发/调试）：启动应用为node --inspect，在Chrome DevTools → Memory面板采集Heap Snapshot，对比不同时间点的快照，定位**保留树（Retainers）**中异常增长的对象与引用链。
- 方式B（生产/线上）：引入heapdump在关键时机写快照，例如：
- 安装：npm i heapdump
- 触发：
- 信号触发：启动命令加上**–heapsnapshot-signal=SIGUSR2**，向进程发送SIGUSR2即可生成快照；
- 代码触发：const heapdump = require(‘heapdump’); heapdump.writeSnapshot(‘/path/snap.heapsnapshot’);
- 方式C（趋势告警）：使用memwatch-next监听疑似泄漏并自动落盘快照：
- 安装：npm i memwatch-next
- 使用：
- const memwatch = require(‘memwatch-next’);
- memwatch.on(‘leak’, info => console.error(‘Memory leak detected:’, info));
- 快照分析要点：在DevTools中按Constructor/Class查看对象数量与大小，依据Retainers追溯是谁在持有对象，优先排查全局变量、闭包、定时器、事件监听器等常见根因。
三 常见根因与修复要点
- 全局变量累积：避免向global写入大数据或缓存，必要时设置TTL/淘汰策略并显式置为null。
- 闭包引用不当：检查闭包是否无意间持有大对象或外部作用域，缩小闭包捕获范围。
- 定时器未清理：不再需要时及时clearInterval/clearTimeout，避免回调与绑定对象无法释放。
- 事件监听器未移除：对EventEmitter/HTTP/WebSocket等在销毁阶段removeListener，或使用once。
- 大文件与批量处理：改用Stream流式处理，避免一次性读入内存。
- 缓存失控：为内存缓存设置大小上限与过期清理，避免无限增长。
四 临时兜底与长期治理
- 兜底策略：使用PM2的max_memory_restart在内存超过阈值时自动重启，保障可用性（仅缓解，不替代修复）。
- 运行环境：优先64位Node.js与系统，获得更充分地址空间与GC表现。
- 版本与依赖：升级Node.js与相关依赖至稳定版本，修复已知内存问题。
- 压力与GC日志：在预发/灰度环境做压力测试复现问题；必要时开启/分析GC日志观察回收频率与停顿，辅助判断泄漏与内存压力。
五 最小可行排查清单
- 用top/htop确认内存持续上升，记录PID与时间点。
- 在代码中加入process.memoryUsage()定时日志，观察heapUsed/rss趋势。
- 以node --inspect启动，打开chrome://inspect准备采集快照。
- 安装并使用heapdump：
- 信号方式：添加**–heapsnapshot-signal=SIGUSR2**，需要时执行kill -SIGUSR2 ；
- 代码方式：在可疑阶段调用heapdump.writeSnapshot(‘/path/file.heapsnapshot’)。
- 用memwatch-next监听“leak”事件，自动告警并落盘快照。
- 在Chrome DevTools Memory对比多份快照，依据Retainers定位泄漏根因并修复；修复后重复采集快照验证回落。
- 若需临时稳定服务，启用PM2 max_memory_restart并尽快完成代码修复。