Cara memperbaiki package lock json rusak paling aman adalah validasi isi JSON dulu, sinkronkan dengan package.json, lalu generate ulang hanya bila perlu. Jangan langsung hapus file karena versi dependency bisa melompat dan memicu error baru. Baca pesan error npm install sampai baris terakhir, biasanya npm sudah menyebut letak JSON invalid atau paket yang mismatch.
Penyebab Package-lock.json Rusak di Node.js
File ini rusak ketika strukturnya tidak lagi valid sebagai JSON atau isinya tidak cocok dengan package.json. Npm membaca keduanya bersamaan, jadi satu saja beda langsung gagal install.
- Merge conflict Git yang belum resolve. Tanda
<<<<<<<membuat JSON tidak bisa diparse. - Edit manual versi paket tanpa update dependensi turunannya.
npm installbatal di tengah jalan karena listrik mati, koneksi putus, atau proses dihentikan.- LockfileVersion beda karena tim memakai versi npm yang tidak sama.
Cek awal paling cepat:
npm install
node -e "JSON.parse(require('fs').readFileSync('package-lock.json','utf8')); console.log('JSON valid')"
Kalau perintah kedua error, masalah ada di sintaks JSON. Kalau JSON valid tapi install tetap gagal, fokus ke mismatch versi.
Cara Memperbaiki Package Lock Json Rusak Langkah Aman
Ikuti urutan ini supaya tidak merusak dependency yang masih sehat:
1. Backup dulu file lama. Salin package-lock.json ke package-lock.json.bak.
2. Validasi JSON dan perbaiki koma, kurung, atau sisa conflict Git.
3. Sinkronkan lock tanpa install ulang semua paket:
npm install --package-lock-only
4. Kalau file sudah terlalu kacau, hapus lock dan generate ulang:
rm package-lock.json
rm -rf node_modules
npm install
Hapus lock file boleh dilakukan saat JSON tidak bisa diselamatkan, setelah merge besar, atau saat versi di lock jauh tertinggal. Risikonya npm mengambil versi minor atau patch terbaru sesuai range di package.json, jadi uji aplikasi setelahnya.
Jangan pakai --force atau --legacy-peer-deps sebagai kebiasaan. Keduanya menyembunyikan konflik dependency dan sering menimbulkan error runtime.
| Masalah | Penyebab | Solusi |
|---|---|---|
| Unexpected token di JSON | Conflict Git atau koma hilang | Hapus marker conflict, validasi JSON ulang |
| Lock tidak sinkron package.json | Install tidak selesai | Jalankan install dengan package-lock-only |
| EBADENGINE atau peer conflict | Versi npm atau Node beda | Samakan versi Node, perbaiki range dependency |
FAQ
Apakah boleh hapus package-lock.json langsung?
Boleh dalam kondisi darurat, tetapi versi dependency bisa berubah dan perlu pengujian ulang.
Kenapa npm install tetap error setelah lock diperbaiki?
Bersihkan cache dengan npm cache verify lalu cek versi npm dan Node yang dipakai.
Bagaimana cegah lock rusak setelah merge?
Selesaikan semua conflict dulu, lalu jalankan npm install --package-lock-only sebelum commit.