Browser menampilkan ERR_CONNECTION_REFUSED artinya Express tidak menerima koneksi pada alamat dan port yang kamu buka. Periksa dulu apakah proses Node jalan, lalu pastikan nilai HOST dan PORT sama antara kode dan URL browser. Sebagian besar kasus selesai setelah memperbaiki app.listen() yang tidak dipanggil atau salah bind ke 127.0.0.1.
Penyebab Express Server Tidak Bisa Diakses
Bedakan tiga kondisi ini sebelum mengubah kode. Server tidak jalan berarti proses Node mati atau crash. Listen salah berarti proses hidup tapi menempel di port atau interface berbeda. Diblokir jaringan berarti server lokal normal, tetapi firewall atau binding HOST menutup akses dari luar.
app.listen()tidak pernah dipanggil karena file server hanya mengekspor app.- PORT berbeda antara kode, file
.env, dan URL browser. - HOST memakai
127.0.0.1sehingga hanya bisa dibuka dari komputer yang sama. - Firewall OS atau VPS menutup port tujuan.
- Proses crash diam-diam karena error synchronous tanpa log terlihat.
| Gejala | Penyebab | Cek Cepat |
|---|---|---|
| Connection refused di localhost | Server mati atau port salah | Cek log terminal dan curl |
| Localhost bisa, IP LAN tidak bisa | Bind ke 127.0.0.1 |
Ubah HOST ke 0.0.0.0 |
| EADDRINUSE saat start | Port dipakai proses lain | Cek dengan ss lalu ganti PORT |
| Sempat jalan lalu mati | Crash atau terminal ditutup | Cek log PM2 atau systemd |
Cara Memperbaiki Express Tidak Bisa Diakses
- Baca log terminal tempat Node dijalankan. Cari pesan error, stack trace, atau pesan listen yang tidak muncul.
- Tes dari localhost dulu dengan
curl http://localhost:3000. Kalau ini gagal, masalah ada di kode atau port, bukan firewall. - Perbaiki HOST dan PORT lewat environment variable. Pakai
0.0.0.0bila server perlu diakses dari LAN, Docker, atau VPS. - Cek firewall dan tabrakan proses. Pastikan port tujuan terbuka dan tidak dipakai aplikasi lain.
const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;
const HOST = process.env.HOST || '0.0.0.0';
const server = app.listen(PORT, HOST, () => {
console.log(`Server jalan di http://${HOST}:${PORT}`);
});
server.on('error', (err) => {
if (err.code === 'EADDRINUSE') {
console.error(`Port ${PORT} sudah dipakai. Hentikan proses lama atau ganti PORT.`);
process.exit(1);
}
throw err;
});
ss -tlnp | grep 3000untuk melihat proses pemilik port.curl -v http://localhost:3000untuk memastikan respons HTTP keluar.pm2 logs nama-app --lines 50untuk melihat crash pada server PM2.
FAQ
Kenapa localhost bisa tapi IP LAN tidak bisa?
Server terikat ke 127.0.0.1, ubah HOST menjadi 0.0.0.0 lalu buka firewall untuk port tersebut.
Kenapa port Express sudah dipakai aplikasi lain?
Port TCP hanya bisa dipakai satu proses listener, hentikan proses lama atau pindahkan Express ke PORT kosong.
Kenapa Express mati setelah terminal ditutup?
Proses Node ikut berhenti bersama sesi terminal, jalankan memakai PM2 atau systemd agar tetap hidup.