Perbaiki Fetch Gagal dengan Cara Mengatasi Enotfound Node Js

Error ENOTFOUND berarti Node.js gagal me-resolve hostname menjadi alamat IP lewat DNS. Fokus perbaikan ada di nama host, konfigurasi DNS, dan environment variable, bukan di kode fetch atau axios itu sendiri. Cek ejaan hostname dulu, lalu uji DNS dari terminal sebelum mengubah kode.

Penyebab ENOTFOUND Paling Sering di Node.js

Kode ini muncul saat fungsi fetch(), axios.get(), atau driver database meminta koneksi ke host yang tidak dikenali resolver DNS.

  • Hostname salah ketik, contoh api.exmaple.com atau ada spasi dan protokol ganda seperti https://https://.
  • DNS tidak bisa dijangkau karena internet putus, DNS kantor bermasalah, atau VPN mengubah resolver.
  • Variable env salah, contoh DB_HOST=localhostt atau API_BASE_URL kosong sehingga request mengarah ke host tidak valid.
  • Koneksi database memakai host internal yang hanya ada di Docker atau VPS, tapi kode dijalankan dari laptop lokal.
  • Proxy atau firewall memblokir lookup DNS eksternal, umum di jaringan kantor dan server production.

Tabel Diagnosis Cepat ENOTFOUND

Baca pesan getaddrinfo ENOTFOUND nama-host. Nama setelah ENOTFOUND adalah target yang gagal di-resolve. Salin nama itu untuk pengujian, jangan mencetak seluruh URL berisi token ke log.

Gejala Penyebab Pemeriksaan awal
fetch ke API eksternal gagal Salah hostname atau DNS lokal Ping host dan uji dengan nslookup
Koneksi MongoDB atau MySQL gagal Host DB salah atau hanya internal Cek DB_HOST di .env
Berhasil lokal, gagal di server DNS atau firewall server Cek resolver dan aturan outbound

Cara Memperbaiki ENOTFOUND Node Js Langkah demi Langkah

Ikuti urutan ini agar akar masalah ketemu tanpa mengubah kode berlebihan.

  1. Salin hostname persis dari error. Periksa typo, spasi, dan jangan sertakan protokol di variabel khusus host.
  2. Uji DNS dari terminal dengan nslookup api.example.com dan ping api.example.com. Jika keduanya gagal, masalah ada di jaringan.
  3. Coba DNS publik seperti 8.8.8.8 atau 1.1.1.1 bila DNS bawaan ISP bermasalah.
  4. Periksa koneksi, VPN, proxy, dan firewall. Nonaktifkan VPN sementara untuk memastikan VPN bukan penyebabnya.
  5. Buka file .env dan cetak nilainya tanpa secret: console.log(process.env.API_BASE_URL). Pastikan tidak undefined atau berisi tanda kutip.
  6. Uji ulang dengan skrip minimal berikut, lalu jalankan request asli bila DNS lolos.
import dns from 'node:dns/promises';

const host = 'api.example.com';
try {
  const result = await dns.lookup(host);
  console.log('DNS OK:', result.address);
  const res = await fetch(`https://${host}/health`);
  console.log('HTTP:', res.status);
} catch (err) {
  console.error(err.code, err.hostname);
}

Jika aplikasi berjalan di belakang proxy kantor, set HTTP_PROXY dan HTTPS_PROXY lewat environment dan pastikan library HTTP yang dipakai mendukung proxy tersebut.

FAQ

Apakah ENOTFOUND berarti server tujuan mati?

Tidak. Kode ini berarti hostname tidak ditemukan di DNS, server belum sempat dihubungi.

Kenapa hostname benar tapi tetap ENOTFOUND?

Resolver DNS yang dipakai sedang gangguan, jaringan memblokir DNS, atau VPN mengubah rute lookup.

Apakah perlu hapus node_modules untuk ENOTFOUND?

Tidak perlu. Itu masalah resolusi nama jaringan, install ulang paket tidak memperbaikinya dan hanya membuang waktu.