cara mengatasi package json invalid berawal dari membaca baris error npm, bukan menghapus folder acak. npm gagal parse saat file package.json bukan JSON valid, sering setelah edit manual. Salin error lengkap, cadangkan file, lalu validasi ulang sebelum install.
Penyebab Package Json Invalid di Node.js
JSON memakai aturan ketat. Satu karakter salah membuat seluruh file ditolak parser Node.js dan npm.
- Koma hilang atau berlebih setelah edit manual, kurung kurawal tidak seimbang, dan kutip satu dipakai untuk key atau string.
- Trailing comma di akhir objek atau array, komentar // dan /* */, serta encoding BOM dari editor teks tertentu.
- File kosong 0 byte atau tertimpa saat merge Git dan copy paste dari browser atau chat yang memotong isi file.
- Duplikat key seperti dua properti name, serta karakter tak terlihat dari hasil paste yang merusak struktur.
Tabel Diagnosis Cepat Package Json Invalid
Cocokkan pesan npm dengan baris yang ditunjuk. Posisi line dan column biasanya akurat.
| Masalah | Penyebab | Solusi |
|---|---|---|
| Unexpected token } in JSON | Koma berlebih atau kurung salah | Hapus koma terakhir, samakan buka tutup objek |
| Unexpected end of JSON input | File terpotong atau kosong | Kembalikan dari backup atau Git, lengkapi struktur |
| File not valid JSON | Komentar, BOM, kutip salah | Hapus komentar, simpan UTF-8 tanpa BOM, pakai kutip dua |
Konteks ini berlaku untuk npm dan Node.js, baik proyek CommonJS dengan require maupun proyek type module dengan import. Sistem modul tidak mengubah format JSON, package.json tetap harus JSON murni.
Cara Memperbaiki Package Json Invalid
Ikuti urutan ini agar perbaikan tercatat dan aman dikembalikan.
- Baca pesan npm sampai baris dan kolom error, catat nama file yang disebut.
- Buat backup sebelum mengubah: cp package.json package.json.bak.
- Validasi isi file dengan perintah berikut.
- Perbaiki hanya bagian rusak, lalu simpan sebagai UTF-8 tanpa BOM.
- Jalankan ulang npm install setelah validasi lolos.
npm pkg get name version
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8')); console.log('JSON valid')"
Contoh package.json minimal yang valid:
{
"name": "backend-app",
"version": "1.0.0",
"type": "commonjs",
"main": "index.js",
"scripts": {
"start": "node index.js"
}
}
Hapus package-lock.json dan perintah –force bukan perbaikan default. Keduanya menyembunyikan sumber error dan berisiko merusak resolusi versi dependency.
FAQ
Kenapa npm error padahal kode terlihat benar?
Karakter tak terlihat, koma berlebih, atau komentar kecil sering lolos dari pengecekan visual dan hanya terbaca parser.
Apakah hapus node_modules memperbaiki package.json invalid?
Tidak, folder itu hasil install sedangkan error berasal dari file package.json yang gagal dibaca npm.
Bagaimana cegah file rusak lagi?
Edit dengan editor berformat JSON, validasi tiap selesai mengubah, dan commit perubahan kecil lewat Git.