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.
- Periksa registry aktif.
npm config get registryharus mengembalikan alamat registry yang dipakai proyek. - Uji koneksi registry. Jalankan
npm ping. Jika gagal, periksa internet, VPN, proxy, tanggal sistem, dan firewall. - Periksa konfigurasi proyek. Buka .npmrc di folder proyek dan home directory. Pastikan URL scope benar dan tidak ada token lama.
- Verifikasi cache tanpa menghapus paksa. Jalankan
npm cache verifyterlebih dahulu. - Perbarui npm dan login ulang bila perlu. Gunakan
npm install -g npm@latest, lalunpm loginuntuk private package. - 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.