Npm Install Gagal Terus? Cara Mengatasi Npm Network Timeout Sampai Berhasil

Jalankan npm install --verbose dulu untuk melihat titik gagalnya, lalu naikkan timeout dan retry npm. Timeout jaringan npm paling sering sembuh setelah ganti registry yang stabil dan membersihkan cache yang korup, bukan dengan mengulang perintah yang sama berkali-kali.

Penyebab Npm Network Timeout Paling Sering

Log npm biasanya menampilkan ETIMEDOUT saat koneksi tidak tersambung, ECONNRESET saat koneksi diputus di tengah unduhan, dan fetch failed saat registry tidak merespons. Catat baris URL dan kode errornya sebelum mengubah konfigurasi.

  • Koneksi WiFi atau tethering putus sesaat saat mengunduh tarball besar.
  • Registry registry.npmjs.org lambat atau diblokir DNS ISP.
  • Proxy atau firewall kantor memblokir port 443 npm.
  • Cache npm korup sehingga retry selalu gagal di paket yang sama.
  • Node.js atau npm terlalu lama dan tidak cocok dengan TLS registry terbaru.

Tabel Diagnosis Cepat Network Timeout

Gejala Penyebab Pemeriksaan awal
ETIMEDOUT ke registry Internet putus Ping registry dan coba browser
Fetch failed berulang Registry sibuk Coba mirror registry
Gagal hanya di kantor Proxy kantor Cek npm proxy config
Gagal di satu paket Cache korup Bersihkan cache npm

Perintah npm install --verbose menampilkan URL paket yang macet. Masalah ada di laptop kalau semua situs lambat. Masalah ada di registry kalau hanya domain npm yang gagal.

Cara Memperbaiki Npm Network Timeout Bertahap

  1. Uji koneksi dan DNS. Pindah ke jaringan lain atau ganti DNS bila perlu.
  2. Kembalikan registry ke default resmi bila sebelumnya memakai mirror tidak stabil.
  3. Naikkan batas timeout dan jumlah retry npm.
  4. Bersihkan cache, lalu install ulang tanpa menghapus lockfile.
npm config set registry https://registry.npmjs.org/
npm config set fetch-timeout 120000
npm config set fetch-retries 5
npm cache verify
npm install --verbose

Menghapus node_modules aman untuk install ulang bersih. Menghapus package-lock.json berisiko menaikkan versi dependency secara diam-diam, jadi lakukan hanya bila lockfile rusak dan catat perubahan versinya.

FAQ

Apakah perlu pakai –force agar install lebih cepat?

Tidak. Flag tersebut menimpa proteksi npm dan bisa merusak dependency, tanpa mempercepat jaringan.

Berapa nilai fetch-timeout yang aman untuk koneksi lambat?

Mulai dari 120000 ms dengan 5 kali retry, lalu naikkan bertahap bila masih timeout.

Kapan harus ganti registry npm ke mirror?

Ganti saat registry utama timeout berulang dari lokasi kamu, dan kembalikan setelah stabil.