Node.js'de bellek sızıntılarını nasıl tespit eder ve düzeltirsiniz?

Question

Accepted Answer

Bir **bellek sızıntısı**, artık gerekli olmayan ancak bir şey tarafından hala referans edildiği için hiçbir zaman serbest bırakılmayan bellektir. Zaman içinde işlemin heap'i büyür ve yavaşlar veya çöker (bellek yetersiz). Uzun süreli Node sunucularında sızıntılar ciddi bir üretim problemidir.

## Yaygın sızıntı kaynakları

```js
// 1. Unbounded caches / global collections that only grow
const cache = new Map();
app.get("/:id", (req, res) => { cache.set(req.params.id, data); }); // never cleared → grows forever

// 2. Forgotten event listeners (added repeatedly, never removed)
emitter.on("data", handler); // if added per-request and never removed → accumulates

// 3. Forgotten timers
setInterval(() => {...}, 1000); // never cleared, holds references alive

// 4. Closures capturing large objects longer than needed
function outer() {
  const huge = loadBigData();
  return () => huge.length; // keeps `huge` alive as long as the closure lives
}
```

Ortak tema: erişilebilir bir referans (global Map, canlı bir listener, çalışan bir timer, bir closure), nesnelerin artık faydalı olmasa bile garbage-collection'dan kurtulmasını engeller.

## Sızıntıları tespit etme

```js
// 1. Watch heap growth over time — steady upward trend = likely leak
setInterval(() => {
  const { heapUsed } = process.memoryUsage();
  console.log(`heap: ${(heapUsed / 1e6).toFixed(1)} MB`);
}, 10000);
```

```bash
# 2. Heap snapshots — capture at two points, compare what grew
node --inspect app.js     # then use Chrome DevTools → Memory → heap snapshots
# or the heapdump / clinic.js tools
```

Teşhis süreci: heap'in sabit bir şekilde büyüdüğünü doğrulayın (sadece normal dalgalanma değil), daha sonra bir workload öncesi ve sonrası **heap snapshot'ları** alın ve hangi nesne türlerinin biriktiğini bulmak için karşılaştırın ("retained size" büyüyor).

## Sızıntıları düzeltme

```js
// ✅ bound caches with TTL/size limits (LRU)
import { LRUCache } from "lru-cache";
const cache = new LRUCache({ max: 1000, ttl: 1000 * 60 }); // evicts automatically

// ✅ always remove listeners and clear timers
emitter.off("data", handler);
clearInterval(timer);

// ✅ use WeakMap/WeakSet for metadata that shouldn't keep objects alive
const meta = new WeakMap(); // entries are GC'd when the key object is
```

Düzeltmeler nedenleri yansıtır: sınırlı cache'ler (maksimum boyut/TTL'li LRU), her zaman listener/timer oluşturma işlemini temizleme ile eşleştirin ve nesneleri bellekte sabitlemeyecek nesne anahtarlı meta veriler için `WeakMap`/`WeakSet` kullanın.

## Neden önemli

Bellek sızıntıları Node'da özellikle tehlikelidir çünkü sunucular **uzun süreli** çalışır — geliştirmede görünmez olan yavaş bir sızıntı, üretim işlemini kademeli olarak bozar ve sonunda çöker (sık sık yeniden başlar ve havada uçan işleri kaybeder).

Klasik kaynakları (sınırsız cache'ler, kaldırılmayan listener'lar/timer'lar, kalan closure'lar), bunları tespit etmeyi (heap izleme + DevTools/clinic.js ile snapshot karşılaştırması) ve düzeltmeleri (sınırlı LRU cache'ler, disiplinli temizlik, `WeakMap`) bilmek, güvenilir ve istikrarlı Node hizmetlerini zaman içinde çalıştırmak için gereklidir.