Install Ditolak Registry, Cara Mengatasi Npm Err Code E404 tanpa Hapus Proyek

npm err code E404 berarti registry npm tidak menemukan nama package atau versi yang tertulis di perintah install dan package.json. Proyek tidak perlu dihapus. Salin nama package dari pesan error, cek ketersediaannya dengan npm view, lalu perbaiki tulisan atau versinya.

Penyebab Npm Err Code E404 Paling Sering

Error ini hampir selalu soal nama, bukan soal koneksi. npm sudah berhasil menghubungi registry, hanya saja objek yang diminta tidak ada.

  • Salah ketik nama package, misalnya express-validator tertulis expressvalidtor.
  • Salah scope private, misalnya @kantor/utils padahal akses registry memakai akun lain.
  • Versi tidak tersedia, misalnya meminta ^3.2.9 padahal versi itu belum pernah dirilis.
  • Package dihapus atau di-unpublish oleh pemilik dari registry npm.
  • Registry salah arah karena .npmrc lama, mirror kantor, atau cache registry custom.

Tabel Diagnosis Cepat Error 404 Npm

Bedakan dulu 404 registry dengan error lain. Timeout menampilkan ETIMEDOUT atau ENOTFOUND, sedangkan masalah izin menampilkan E403 atau EPERM.

Masalah Penyebab Solusi
404 nama package Salah ketik atau salah scope Cek lewat npm view
404 versi tertentu Versi belum rilis atau dihapus Pakai versi yang terdaftar
Semua install 404 registry di .npmrc salah Reset ke registry npm resmi

Perintah verifikasi awal:

npm config get registry
npm view nama-package versions
cat package.json

Cara Memperbaiki Npm Err Code E404 Langkah demi Langkah

Ikuti urutan ini agar tidak merusak proyek yang sebenarnya sehat.

  1. Salin pesan error lengkap. Catat baris 404 Not Found - GET https://registry.npmjs.org/... untuk tahu package mana yang gagal.
  2. Verifikasi ke registry dengan perintah npm view nama-package versions. Kalau hasilnya 404 juga, nama package memang salah.
  3. Perbaiki package.json, lalu install ulang tanpa menghapus lockfile dulu:
    npm install nama-package-yang-benar --save
  4. Kalau memakai mirror atau .npmrc lama, kembalikan registry dan bersihkan cache:
    npm config set registry https://registry.npmjs.org/
    npm cache verify

Jangan langsung hapus node_modules dan package-lock.json untuk error 404. Keduanya tidak memperbaiki nama yang salah, malah menghilangkan catatan versi yang masih baik. Opsi --force juga tidak relevan karena masalahnya bukan konflik dependency.

FAQ

Apakah npm err code E404 berarti internet bermasalah?

Tidak. 404 berarti koneksi ke registry berhasil, tetapi package atau versi yang diminta tidak ditemukan.

Kenapa package ada di GitHub tapi tetap 404 di npm?

GitHub dan npm adalah registry berbeda. Pemilik harus mempublish manual ke npm sebelum bisa di-install lewat npm install.

Apakah npm install versi terbaru selalu memperbaiki E404?

Tidak. Kalau nama package salah, versi terbaru pun tetap 404 sampai namanya diperbaiki.