Jangan install ulang Node.js dulu. Error npm cache corrupted hampir selalu sembuh dengan npm cache verify, lalu npm cache clean –force bila verifikasi gagal. Cache npm hanya salinan paket unduhan, bukan instalasi Node.js itu sendiri.
Penyebab Npm Cache Corrupted Paling Sering
Cache corrupt berarti file tarball di folder cache tidak lengkap atau checksum-nya tidak cocok. npm lalu menolak memakai file itu dan menampilkan ENOENT, EINTEGRITY, atau Z_DATA_ERROR.
- Proses npm install dibatalkan paksa dengan Ctrl+C atau laptop mati mendadak.
- Disk penuh sehingga file cache hanya tertulis sebagian.
- Antivirus, OneDrive, Dropbox, atau Google Drive mengunci file saat npm menulis cache.
- Versi Node.js dan npm tidak sinkron, misalnya pindah versi Node tanpa update npm.
Tabel Diagnosa Error Cache Npm
Tidak semua gagal install berarti cache rusak. Bedakan gejalanya:
| Pesan Error | Penyebab | Solusi Awal |
|---|---|---|
| EINTEGRITY / cache corrupted | File cache tidak lengkap | npm cache verify |
| EACCES permission denied | Folder npm milik root / admin | Perbaiki permission, jangan sudo install |
| ETIMEDOUT / EAI_AGAIN | Jaringan atau registry down | Cek internet dan registry npm |
Cara Memperbaiki Cache Npm yang Corrupted
Kerjakan berurutan dari yang paling aman:
- Jalankan verifikasi. Perintah ini memeriksa integritas tanpa menghapus semuanya.
npm cache verify - Jika error masih muncul, bersihkan cache secara paksa.
npm cache clean --force - Hapus node_modules lalu install ulang dependensi.
rm -rf node_modules npm install
Flag –force menghapus seluruh cache sehingga install berikutnya mengunduh ulang dan lebih lambat. Hapus node_modules aman karena bisa dibuat ulang, tetapi jangan hapus package-lock.json kecuali file itu ikut rusak. Menghapus lock file mengubah versi resolved semua paket.
FAQ
Apakah npm cache clean –force aman?
Aman, hanya menghapus unduhan sementara dan membuat install berikutnya lebih lambat.
Kapan perlu hapus folder npm cache manual?
Hanya bila verify dan clean gagal karena folder terkunci atau permission rusak.
Kenapa error muncul lagi setelah cache dibersihkan?
Penyebabnya biasanya disk penuh, antivirus, atau registry bermasalah, bukan cache itu sendiri.