Cara Mengatasi Npm Registry Error agar Install Package Lancar Lagi

Cara mengatasi npm registry error paling cepat adalah memastikan npm memakai registry yang benar lalu memverifikasi koneksi. Jalankan npm config get registry dan npm ping, registry default seharusnya https://registry.npmjs.org/. Jika ping gagal, masalahnya hampir pasti jaringan, proxy, VPN, atau URL registry yang salah.

Penyebab Umum Npm Registry Error di Proyek Node.js

Pesan error npm terlihat mirip, tetapi kodenya menunjuk ke lapisan berbeda. Baca kode seperti ECONNRESET atau E401 sebelum menghapus apa pun.

  • ECONNRESET, ETIMEDOUT, ENOTFOUND: koneksi putus, DNS gagal, internet tidak stabil, atau diblokir proxy, VPN, dan firewall kantor.
  • E401 Unauthorized: token hilang, kedaluwarsa, atau .npmrc memakai kredensial proyek lain.
  • E403 Forbidden: akun tidak punya akses ke private package atau scope registry salah.
  • E503, E500, EAI_AGAIN: registry tujuan down, overload, atau custom registry dan mirror lokal bermasalah.
  • Registry URL salah: ada spasi, slash ganda, HTTP bukan HTTPS, atau scope menunjuk ke server lama.
  • Cache rusak: install berhenti di tengah jalan sehingga metadata npm tidak konsisten.

Tabel Diagnosis Cepat Berdasarkan Pesan Error

Cocokkan pesan dengan pemeriksaan awal berikut sebelum mengubah konfigurasi.

Pesan Error Penyebab Cek Awal
ENOTFOUND, EAI_AGAIN DNS atau internet Cek koneksi dan matikan VPN sementara
ETIMEDOUT, ECONNRESET Jaringan lambat atau proxy Jalankan npm ping dan cek proxy
E401 Unauthorized Token tidak valid Periksa .npmrc lalu npm login ulang
E503 Service Unavailable Registry down Coba registry default npm

Perbaiki Konfigurasi Registry dan Koneksi Npm

Ikut urutan ini agar tidak merusak proyek yang sebenarnya hanya bermasalah koneksi.

  1. Periksa registry aktif. npm config get registry harus mengembalikan alamat registry yang dipakai proyek.
  2. Uji koneksi registry. Jalankan npm ping. Jika gagal, periksa internet, VPN, proxy, tanggal sistem, dan firewall.
  3. Periksa konfigurasi proyek. Buka .npmrc di folder proyek dan home directory. Pastikan URL scope benar dan tidak ada token lama.
  4. Verifikasi cache tanpa menghapus paksa. Jalankan npm cache verify terlebih dahulu.
  5. Perbarui npm dan login ulang bila perlu. Gunakan npm install -g npm@latest, lalu npm login untuk private package.
  6. Reset ke registry default bila memakai mirror bermasalah. Gunakan npm config set registry https://registry.npmjs.org/.
npm config get registry
npm ping
npm cache verify
npm login
npm config set registry https://registry.npmjs.org/

Jangan menjadikan --force, hapus package-lock.json, atau hapus node_modules sebagai solusi pertama. Opsi paksa dapat menyembunyikan konflik dependensi, sedangkan menghapus lockfile dapat menaikkan versi dependensi tanpa disadari. Pakai hanya setelah registry terbukti normal tetapi install tetap gagal, lalu install ulang dan uji aplikasi.

FAQ

Apakah registry npm sedang down?

Cek halaman status resmi npm melalui kanal resminya, lalu uji npm ping dengan registry default.

Kenapa error 401 saat install private package?

Token auth kedaluwarsa atau scope salah, jadi perbarui token lalu jalankan npm login ulang.

Perlu ganti ke mirror registry?

Ganti hanya bila koneksi ke registry default lambat atau sering timeout, dan kembali bila mirror tidak stabil.