Port 3000 Bentrok Terus? Ini Cara Mengatasi Eaddrinuse Node JS

Error EADDRINUSE: address already in use :::3000 artinya port 3000 sudah dipakai proses lain. Solusi tercepat: hentikan proses yang menahan port itu, lalu jalankan ulang server Node.js. Kalau proses itu masih dibutuhkan, pindahkan aplikasi ke port lain lewat process.env.PORT.

Penyebab EADDRINUSE di Node.js

Node.js hanya mengizinkan satu proses mendengarkan satu port dalam satu waktu. app.listen(3000) gagal kalau port sudah dikunci.

  • Server sebelumnya belum dimatikan, terminal ditutup tapi proses masih jalan.
  • Dua terminal menjalankan node index.js atau npm run dev bersamaan.
  • Nodemon restart tapi proses lama belum mati.
  • PM2 menjalankan dua instance dengan port sama.
  • Port default 3000 bentrok dengan aplikasi lain.
Pesan Penyebab Solusi cepat
listen EADDRINUSE :::3000 Proses Node lama masih jalan Hentikan PID lalu restart
Error setelah nodemon restart Proses ganda Matikan semua nodemon, jalankan satu
Bentrok dengan aplikasi lain Port dipakai non-Node Ganti PORT di .env

Cara Memeriksa Port yang Bentrok

  1. Baca log error lengkap dan catat angka port, contoh :::3000.
  2. Periksa kode dan file .env. Pastikan nilai PORT konsisten.
  3. Cari PID yang memakai port tersebut sesuai sistem operasi.
  • macOS atau Linux: lsof -i :3000 atau ss -tulpn | grep 3000
  • Windows CMD: netstat -ano | findstr :3000
  • Windows PowerShell: Get-Process -Id (Get-NetTCPConnection -LocalPort 3000).OwningProcess
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server jalan di port ${PORT}`);
});

Cara Memperbaiki EADDRINUSE Tanpa Merusak Proses Lain

  1. Hentikan hanya PID yang memakai port target. Jangan langsung kill semua Node.
  2. Jika proses itu penting, jangan dimatikan. Ganti port aplikasi baru.
  3. Tambahkan penanganan error agar pesan lebih jelas.
  4. Gunakan graceful shutdown dengan SIGTERM dan SIGINT.
  • kill PID untuk menghentikan satu proses spesifik.
  • killall node hanya untuk development saat banyak proses nyangkut.
  • Windows: taskkill /PID 1234 /F setelah dapat PID dari netstat.
  • Ganti port lebih aman di server production dan saat memakai PM2.
const server = app.listen(PORT);
server.on('error', (err) => {
  if (err.code === 'EADDRINUSE') {
    console.error(`Port ${PORT} sudah dipakai`);
    process.exit(1);
  }
  throw err;
});

FAQ

Kenapa EADDRINUSE muncul lagi setelah restart?

Proses lama belum benar-benar mati atau PM2 menjalankan ulang instance ganda.

Apakah aman kill semua proses Node?

Tidak selalu aman, hentikan satu PID spesifik dulu kecuali di development lokal.

Bagaimana agar port otomatis ganti saat bentrok?

Tambahkan logika fallback yang mencoba port berikutnya saat menangkap error EADDRINUSE.