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.comatau ada spasi dan protokol ganda sepertihttps://https://. - DNS tidak bisa dijangkau karena internet putus, DNS kantor bermasalah, atau VPN mengubah resolver.
- Variable env salah, contoh
DB_HOST=localhosttatauAPI_BASE_URLkosong 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.
- Salin hostname persis dari error. Periksa typo, spasi, dan jangan sertakan protokol di variabel khusus host.
- Uji DNS dari terminal dengan
nslookup api.example.comdanping api.example.com. Jika keduanya gagal, masalah ada di jaringan. - Coba DNS publik seperti 8.8.8.8 atau 1.1.1.1 bila DNS bawaan ISP bermasalah.
- Periksa koneksi, VPN, proxy, dan firewall. Nonaktifkan VPN sementara untuk memastikan VPN bukan penyebabnya.
- Buka file
.envdan cetak nilainya tanpa secret:console.log(process.env.API_BASE_URL). Pastikan tidak undefined atau berisi tanda kutip. - 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.