Jangan Biarkan Server Mati Mendadak, Ini Cara Mengatasi Uncaught Exception Node Js yang Tepat

Uncaught exception membuat proses Node.js berhenti karena error tidak tertangkap di mana pun. Perbaikan yang tepat menutup sumber error dengan try/catch, validasi, dan penanganan promise, bukan sekadar menahan proses agar tetap hidup. Handler global hanya untuk mencatat log dan mematikan server secara rapi.

Penyebab Uncaught Exception Paling Sering di Node.js

Node.js membedakan tiga jalur error yang sering tertukar. Thrown error keluar dari fungsi sinkron, rejected promise tanpa catch muncul dari kode async, dan error callback async muncul dari pola callback lama.

  • JSON.parse gagal karena body request bukan JSON valid.
  • Akses properti dari nilai null atau undefined, misalnya user.profile.name.
  • Lupa await lalu lupa .catch, sehingga rejection tidak terpantau.
  • Callback fs atau database mengabaikan argumen err.
  • Middleware Express melempar error tanpa diteruskan ke middleware error.

Baca stack trace dari atas ke bawah:

  • Nama error dan pesannya.
  • File dan nomor baris pemicu.
  • Nama fungsi dan urutan pemanggilan sampai ke kode aplikasi.

Tabel Diagnosis Cepat Uncaught Exception

Gejala Penyebab Solusi awal
Crash saat start Config salah, require gagal Periksa stack trace baris pertama
Crash setelah request tertentu Validasi body kurang Reproduksi dengan payload sama
UnhandledRejection Promise tanpa catch Tambah catch di ujung rantai
Error acak di produksi Race condition async Tambah log konteks request

Cara Memperbaiki Uncaught Exception Tanpa Menutup Bug

  1. Reproduksi error dengan input dan urutan request yang sama.
  2. Salin stack trace lengkap, catat file, baris, dan fungsi pemicu.
  3. Isolasi modul bermasalah dengan mematikan route atau job terkait.
  4. Tambah try/catch di batas async, lalu validasi input sebelum dipakai.
  5. Uji ulang dengan input normal, kosong, dan format salah.
process.on("uncaughtException", (err) => {
  console.error("uncaughtException:", err);
  process.exit(1);
});

process.on("unhandledRejection", (reason) => {
  console.error("unhandledRejection:", reason);
  process.exit(1);
});

Kode di atas hanya pengaman terakhir. Setelah log tercatat, perbaiki fungsi asalnya. Server sebaiknya dijalankan ulang oleh PM2, Docker, atau systemd setelah exit agar mulai dari state bersih.

FAQ

Apakah process.on uncaughtException boleh membiarkan server tetap jalan?

Tidak disarankan karena state memori bisa rusak, lebih aman mencatat log lalu exit dan restart.

Apa beda uncaughtException dan unhandledRejection?

UncaughtException berasal dari throw sinkron yang tak tertangkap, sedangkan unhandledRejection berasal dari promise yang gagal tanpa catch.

Kenapa server tetap crash setelah pasang try/catch?

Kemungkinan try/catch terpasang di fungsi yang salah, error terjadi di callback lain, atau ada promise tanpa catch di luar blok tersebut.