記憶體洩漏是 Node.js 長期運行服務的隱形殺手:V8 GC 頻率暴增導致 CPU 飆升、檔案描述符/資料庫連線耗盡、最終進程 OOM 崩潰。Mozilla Identity 團隊開發 node-memwatch,提供跨平台、無需外部工具、生產環境可用的洩漏偵測與定位能力。本文深度解析其三大核心功能與實戰排查流程。
EMFILE、ECONNREFUSED。emitter.on('event', handler) 無對應 off,Emitter 持有 Handler 參考,Handler 閉包又引用大量物件。http.ClientRequest 監聽器未釋放 (僅缺兩字母修復)。leak 事件:自動洩漏預警var memwatch = require('memwatch');
memwatch.on('leak', function(info) {
console.error('⚠️ 疑似記憶體洩漏:', info);
// info 範例:
// { start: Fri, 29 Jun 2012 14:12:13 GMT,
// end: Fri, 29 Jun 2012 14:12:33 GMT,
// growth: 67984,
// reason: 'heap growth over 5 consecutive GCs (20s) - 11.67 mb/hr' }
});
算法:連續 5 次 GC 後堆積持續增長且未釋放 → 觸發 leak 事件。零配置、零侵入、生產環境可直接啟用。
stats 事件:GC 後堆統計快照memwatch.on('stats', function(stats) {
// stats 包含:
// current_base, estimated_base, num_full_gc, num_inc_gc,
// heap_compactions, usage_trend, min, max ...
// 可接入監控系統 (Datadog/Prometheus/Grafana) 繪製趨勢圖
});
利用 V8 AddGCEpilogueCallback 鉤子,每次完整 GC 後自動採樣,反映真實「基準記憶體」趨勢 (扣除暫時性分配)。
HeapDiff 類別:精準定位洩漏物件var hd = new memwatch.HeapDiff();
// ... 執行疑似洩漏代碼 ...
var diff = hd.end();
console.log(diff);
/*
{
before: { nodes: 11625, size_bytes: 1869904, size: '1.78 mb' },
after: { nodes: 21435, size_bytes: 2119136, size: '2.02 mb' },
change: {
size_bytes: 249232, size: '243.39 kb',
freed_nodes: 197,
allocated_nodes: 10007,
details: [
{ what: 'Array', size_bytes: 66688, size: '65.13 kb', '+': 1000, '-': 50 },
{ what: 'String', size_bytes: 123456, size: '120.5 kb', '+': 5000, '-': 100 },
{ what: 'Closure', size_bytes: 45678, size: '44.6 kb', '+': 200, '-': 0 }, // 關鍵線索!
{ what: 'MyCustomClass', size_bytes: 12345, '+': 150, '-': 0 }
]
}
}
*/
details 陣列按類型分組顯示新增/釋放數量與記憶體增量,Closure (閉包) 數量持續增長且不釋放是洩漏鐵證。
// 需啟動參數: node --expose-gc app.js
var stats = memwatch.gc(); // 強制完整 GC,回傳 stats 物件
memwatch.on('leak', ...),接入告警系統 (PagerDuty/Slack/Email)。stats 事件寫入時序資料庫,建立基準記憶體趨勢儀表板。HeapDiff 前後快照 → 分析 details 找出增長最快的物件類型。Closure、Array、自定類別) → 搜尋對應代碼路徑 → 確認未移除監聽器/未清理快取/遞迴引用。leak 不再觸發、HeapDiff 穩定。HeapDiff (有效能開銷),leak/stats 事件開銷極低可全量開啟。--max-old-space-size 限制堆上限,觸發 OOM 前先拋出錯誤,便於捕獲堆快照 (配合 heapdump 模組)。| 工具 | 定位 | 優缺點 |
|---|---|---|
node-memwatch | 線上偵測/預警/定位 | ✅ 跨平台、生產可用、API 簡單 ❌ HeapDiff 有開銷 |
v8-profiler + node-inspector | 開發期深度剖析 | ✅ WebKit DevTools 介面、完整堆快照 ❌ 需暫停進程、難用於線上 |
heapdump | OOM 現場保存 | ✅ 信號觸發寫入檔案、事後離線分析 ❌ 檔案巨大 (GB 級) |
dtrace / mdb (SmartOS) | 核心級動態追蹤 | ✅ 零侵入、極深可見性 ❌ 僅限 SmartOS/illumos |
記憶體洩漏不可怕,可怕的是「不知道它存在」。將 node-memwatch 納入標準監控體系,建立「預警→定位→修復→驗證」閉環,讓 Node.js 服務在月份級、年份級運行中依然穩如磐石。