cara mengatasi express app listen error paling cepat adalah menghentikan proses yang memakai port tersebut lalu memastikan app.listen() hanya dipanggil sekali dengan PORT yang benar. Error ini hampir selalu muncul sebagai EADDRINUSE di terminal saat kamu menjalankan ulang server Node.js.
Penyebab Express App Listen Error Paling Sering
Kode EADDRINUSE berarti port sudah dipakai proses lain. Kode EACCES berarti Node.js tidak punya izin memakai port tersebut, biasanya port di bawah 1024. Error callback listen biasanya muncul karena server gagal start tapi kode tetap lanjut jalan.
- Proses nodemon atau node lama masih jalan di port 3000.
- Terminal ditutup tapi proses tidak benar-benar mati.
- Variabel
PORTberbeda antara file.envdan kode. app.listen()dipanggil dua kali di file berbeda.- Port dipakai aplikasi lain seperti database, Docker, atau frontend dev server.
Tabel Diagnosis Cepat App Listen Error
Baca pesan error lengkap di terminal sebelum mengubah kode. Gunakan lsof atau netstat untuk memastikan siapa pemakai port.
| Pesan Error | Penyebab | Pemeriksaan |
|---|---|---|
| EADDRINUSE: address already in use :::3000 | Port dipakai proses aktif | Cek proses lama dan hentikan |
| EACCES / permission denied | Port butuh hak akses root | Pindah ke port 3000 ke atas |
| ERR_SERVER_ALREADY_LISTEN | listen dipanggil dua kali | Cari duplikat app.listen |
Cara Memperbaiki Express App Listen Error
- Hentikan server lama dengan
Ctrl+C, lalu cek proses yang tersisa. - Cari pemakai port dengan perintah sistem, contoh
lsof -i :3000di macOS atau Linux. - Hentikan PID tersebut atau ganti
PORTke port kosong seperti 3001. - Perbaiki kode agar hanya ada satu
app.listendan PORT dibaca dari environment. - Jalankan ulang server dan validasi dengan
curlatau browser.
const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;
app.get('/', (req, res) => {
res.json({ status: 'ok' });
});
const server = app.listen(PORT, () => {
console.log(`Server jalan di port ${PORT}`);
});
server.on('error', (err) => {
console.error(err.message);
});
Validasi dengan curl http://localhost:3000/. Jika masih gagal, baca output listener error untuk memastikan penyebabnya bukan kode route.
FAQ
Kenapa port 3000 tetap EADDRINUSE setelah terminal ditutup?
Proses Node.js masih berjalan di background, hentikan manual lewat daftar proses sistem.
Apakah boleh langsung ganti port saat listen error?
Boleh untuk development, tetapi pastikan proses lama dihentikan agar tidak menumpuk.
Kenapa app.listen dipanggil dua kali memicu error?
Server pertama sudah memakai port, sehingga pemanggilan kedua langsung ditolak sistem.