Batas heap default Node.js (V8) umumnya sekitar 2 GB pada sistem 64-bit, tapi bisa lebih kecil di VPS kecil atau Node lama. Error JavaScript heap out of memory berarti proses butuh memori lebih besar dari batas itu sekaligus. Cara mengatasi node js heap out of memory paling cepat adalah menaikkan batas sementara, lalu memperbaiki kode yang menahan memori.
NODE_OPTIONS=--max-old-space-size=4096 npm run build
node --max-old-space-size=4096 server.js
Penyebab Node Js Heap Out Of Memory Paling Sering
V8 membatasi heap agar garbage collector tetap cepat. Di development, hot reload dan source map membuat pemakaian memori lebih besar. Di production, beban data nyata yang memicu crash.
- Memory leak: array global yang terus di-push, cache tanpa TTL, EventEmitter tanpa removeListener, closure menahan objek besar.
- Proses berat sekaligus: build frontend besar, parse JSON atau CSV ratusan MB, agregasi database lalu disimpan semua di RAM.
- Promise.all masif: ribuan request HTTP atau query database dijalankan bersamaan.
- Baca file utuh: fs.readFile atau fs.readFileSync untuk file besar, seharusnya memakai stream.
Tabel Diagnosis Cepat Berdasarkan Gejala
| Gejala | Penyebab | Cek Awal |
|---|---|---|
| Crash saat build | Bundler kehabisan heap | Ulangi dengan max-old-space-size |
| Crash saat upload file besar | File dibaca utuh ke RAM | Cek fs.readFile, ganti stream |
| Memori naik terus | Leak atau cache bocor | Log process.memoryUsage |
| OOM acak di production | Concurrency berlebih | Ambil heap snapshot |
Cara Memperbaiki Node Js Heap Out Of Memory Langkah demi Langkah
Ikuti urutan ini agar perbaikan tidak hanya menunda crash.
1. Baca stack trace dan ulangi dengan memori tercatat. Catat file dan baris yang gagal, lalu pantau heap sebelum crash.
setInterval(() => {
const m = process.memoryUsage();
console.log(Math.round(m.heapUsed / 1024 / 1024) + ' MB');
}, 5000);
2. Naikkan heap sementara untuk memastikan aplikasi jalan. Tambahkan di script package.json bila perlu.
{
"scripts": {
"build": "NODE_OPTIONS=--max-old-space-size=4096 next build",
"start": "NODE_OPTIONS=--max-old-space-size=2048 node server.js"
}
}
3. Perbaiki kode: streaming file, paginasi query, batasi concurrency.
const fs = require('fs');
fs.createReadStream('data.csv')
.on('data', (chunk) => {
processChunk(chunk);
});
- Ambil data database per 500 sampai 1.000 baris, bukan SELECT semua.
- Ganti Promise.all 10.000 item dengan batch 10 sampai 50.
- Bersihkan timer, listener, dan cache yang tidak dipakai.
4. Pisahkan proses berat dengan child_process. Build, konversi video, atau parsing besar sebaiknya jalan di proses worker agar server utama tidak ikut mati.
FAQ
Apakah menambah –max-old-space-size memperbaiki memory leak?
Tidak. Flag itu hanya memperbesar batas, leak tetap membuat memori habis lebih lama.
Berapa nilai max-old-space-size yang aman untuk VPS kecil?
Untuk RAM 1 GB pakai 512 sampai 768, untuk RAM 2 GB pakai 1024 sampai 1536 agar OS tetap punya ruang.
Kapan harus memakai streaming daripada menaikkan memori?
Pakai streaming setiap data tidak muat nyaman di RAM, terutama file upload, CSV, JSON besar, dan query berbaris banyak.