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.jsataunpm run devbersamaan. - 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
- Baca log error lengkap dan catat angka port, contoh
:::3000. - Periksa kode dan file
.env. Pastikan nilaiPORTkonsisten. - Cari PID yang memakai port tersebut sesuai sistem operasi.
- macOS atau Linux:
lsof -i :3000atauss -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
- Hentikan hanya PID yang memakai port target. Jangan langsung kill semua Node.
- Jika proses itu penting, jangan dimatikan. Ganti port aplikasi baru.
- Tambahkan penanganan error agar pesan lebih jelas.
- Gunakan graceful shutdown dengan
SIGTERMdanSIGINT.
kill PIDuntuk menghentikan satu proses spesifik.killall nodehanya untuk development saat banyak proses nyangkut.- Windows:
taskkill /PID 1234 /Fsetelah 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.