npm err network berarti npm gagal menghubungi registry, bukan kode program kamu yang rusak. Perbaiki jalur koneksinya dulu: cek internet dan DNS, pastikan registry benar, lalu ulangi install tanpa --force.
Penyebab Npm Err Network Paling Sering
Log lengkap biasanya ada di file npm-debug.log. Cari kode seperti ETIMEDOUT, ECONNRESET, atau EAI_AGAIN untuk tahu titik gagalnya.
- Koneksi putus, lambat, atau DNS gagal resolve
registry.npmjs.org. - Registry salah, sedang gangguan, atau diblokir jaringan kantor.
- Proxy, VPN, firewall, dan antivirus memutus request HTTPS npm.
- Cache npm rusak atau versi Node dan npm terlalu lama.
Tabel Diagnosis Cepat Npm Err Network
| Pesan Error | Penyebab | Cek Pertama |
|---|---|---|
ETIMEDOUT |
Koneksi lambat atau request tertahan | Ping registry dan ulangi install |
ECONNRESET |
VPN, proxy, atau firewall memutus koneksi | Matikan VPN dan cek proxy npm |
ENOTFOUND / EAI_AGAIN |
DNS bermasalah | Ganti DNS dan cek npm config get registry |
Cara Memperbaiki Npm Err Network Langkah demi Langkah
Lakukan berurutan supaya penyebab paling ringan teratasi dulu.
- Cek koneksi dan status registry. Jalankan
ping registry.npmjs.org, buka registry di browser, lalu coba jaringan lain bila perlu. - Ulangi install dengan retry aman. Jangan langsung pakai
--forcekarena itu tidak memperbaiki jaringan. - Perbaiki registry, proxy, dan SSL. Pastikan tidak ada typo pada URL registry.
- Bersihkan cache dengan
npm cache verify. Perintah ini lebih aman daripada hapus cache manual. - Update Node dan npm bila versinya sudah jauh tertinggal.
npm config get registry
npm config set registry https://registry.npmjs.org/
npm config delete proxy
npm config delete https-proxy
npm cache verify
npm install
Jika memakai proxy kantor, isi proxy sesuai aturan jaringan tersebut. Jika tidak memakai proxy, kedua nilainya harus kosong.
Menghapus node_modules dan package-lock.json berisiko menimbulkan perbedaan versi dependency. Cadangkan dulu folder proyek dan lakukan hanya bila cache serta konfigurasi sudah benar tetapi install tetap gagal.
FAQ
Apakah npm err network berarti registry npm down?
Belum tentu, penyebab terbanyak adalah koneksi lokal, DNS, VPN, atau proxy.
Kenapa npm err network hanya terjadi di WiFi kantor?
Umumnya firewall kantor memblokir registry atau traffic harus lewat proxy tertentu.
Apakah aman memakai –force untuk error network?
Tidak disarankan karena tidak memperbaiki jaringan dan dapat menimpa instalasi yang belum lengkap.