Browser Menolak Koneksi? Ini Cara Mengatasi Express Server Tidak Bisa Diakses

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.1 sehingga 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

  1. Baca log terminal tempat Node dijalankan. Cari pesan error, stack trace, atau pesan listen yang tidak muncul.
  2. Tes dari localhost dulu dengan curl http://localhost:3000. Kalau ini gagal, masalah ada di kode atau port, bukan firewall.
  3. Perbaiki HOST dan PORT lewat environment variable. Pakai 0.0.0.0 bila server perlu diakses dari LAN, Docker, atau VPS.
  4. 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 3000 untuk melihat proses pemilik port.
  • curl -v http://localhost:3000 untuk memastikan respons HTTP keluar.
  • pm2 logs nama-app --lines 50 untuk 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.