Aplikasi Tiba-Tiba Mati? Cara Mengatasi Process Exited Code 1 Node Js dari Log

Exit code 1 berarti proses Node.js berhenti karena error yang tidak tertangani. Periksa baris pertama stack trace sebelum baris itu, bukan baris paling bawah, karena di situlah file dan penyebab aslinya tertulis. Jalankan ulang dengan log penuh, lalu perbaiki sumber errornya.

Penyebab Process Exited Code 1 Paling Sering

Node.js memakai exit code 1 untuk kegagalan umum. Proses langsung mati ketika error lolos dari semua penanganan.

  • Uncaught exception: error dilempar di dalam route Express, callback, atau fungsi async tanpa try/catch.
  • Unhandled promise rejection: promise gagal tanpa .catch. Satu rejection bisa menghentikan seluruh proses, terutama bila digabung dengan Promise.all.
  • Koneksi database gagal: string koneksi salah, database belum jalan, atau kredensial tidak terbaca.
  • Variabel env hilang: process.env.DB_URL undefined karena file .env tidak dimuat di server.
  • Gagal import: salah path require atau import, tertukar CommonJS dan ES Module, atau package belum diinstal.
  • Script npm salah: perintah di package.json menunjuk file yang tidak ada atau memakai flag Node yang tidak valid.

Tabel Diagnosis Cepat Berdasarkan Pesan Error

Baca log dari atas. Cari kata Error, Cannot, Failed, atau Rejected, lalu cocokkan polanya.

Masalah Penyebab Solusi
Cannot find module Path salah atau belum npm install Perbaiki path dan cek package.json
ECONNREFUSED Database belum jalan Nyalakan database dan cek host
undefined env .env tidak dimuat Validasi process.env saat startup
SyntaxError Sintaks salah atau module tertukar Jalankan node –check
Unhandled rejection Promise tanpa catch Tambahkan try/catch di async
  • Gunakan pm2 logs nama-app –lines 100 untuk PM2 dan docker logs nama-container –tail 100 untuk Docker.
  • Exit code 1 jarang berarti port bentrok. Port bentrok biasanya menampilkan EADDRINUSE secara jelas.
  • Jangan mencetak token atau password ke log saat debug koneksi.

Cara Memperbaiki Process Exited Code 1

Ikuti urutan ini supaya tidak menebak-nebak.

  1. Reproduksi error secara lokal dengan npm start.
  2. Aktifkan log penuh dan simpan stack trace lengkapnya.
  3. Periksa package.json, pastikan main dan scripts menunjuk file yang benar.
  4. Validasi environment variable sebelum konek database.
  5. Perbaiki try/catch di fungsi async yang dicurigai.
  6. Uji ulang, lalu deploy setelah lokal benar-benar stabil.
if (!process.env.DB_URL) {
  console.error("DB_URL belum diisi");
  process.exit(1);
}

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

async function start() {
  try {
    await connectDB(process.env.DB_URL);
    app.listen(process.env.PORT || 3000);
  } catch (err) {
    console.error(err);
    process.exit(1);
  }
}
start();
  • Jalankan node –check index.js untuk memastikan tidak ada syntax error.
  • Cek package.json, terutama type module, dependencies, dan scripts.
  • Pastikan file .env ikut tersedia di server production dengan cara yang aman.

FAQ

Apakah exit code 1 selalu berarti bug di kode?

Tidak. Konfigurasi hilang, database mati, atau env kosong juga bisa memicunya.

Bagaimana melihat log lengkap saat proses langsung mati?

Jalankan manual lewat terminal atau gunakan pm2 logs dan docker logs dengan opsi tail.

Kenapa aplikasi normal lokal tapi exit code 1 saat deploy?

Umumnya karena .env belum dipasang, variabel production beda, atau database server belum bisa diakses.