Stop Pakai –Force Dulu, Cara Mengatasi Npm Peer Dependency Error yang Aman

Cara mengatasi npm peer dependency error yang aman adalah membaca log ERESOLVE dulu, lalu menyamakan versi package yang bentrok, bukan langsung menjalankan –force. Flag itu hanya menyembunyikan konflik dan sering memunculkan error runtime seperti React invalid hook call.

Penyebab ERESOLVE Peer Dependency di npm

Kode ERESOLVE berarti npm gagal menemukan satu versi yang memenuhi semua syarat versi. Sebuah plugin meminta versi peer tertentu, sedangkan proyek kamu memasang versi lain.

Bedakan tiga jenis dependensi di package.json:

  • dependencies: package yang dibutuhkan aplikasi saat berjalan.
  • devDependencies: package untuk build, lint, dan testing.
  • peerDependencies: package tidak ikut diinstal otomatis, tapi harus disediakan proyek induk. Umum dipakai plugin.

npm versi 7 ke atas memeriksa peer secara strict. Itu sebabnya proyek lama yang dulu bisa diinstal di npm 6 sekarang gagal. Kasus paling sering:

  • Plugin eslint-config lama meminta eslint versi 7, proyek sudah memakai eslint versi 8.
  • Library UI meminta react versi 17, proyek sudah naik ke react versi 18.
  • Dua plugin meminta versi major berbeda dari package yang sama.

Tabel Diagnosis Cepat Peer Dependency Error

Baca 10 baris pertama log ERESOLVE. Nama package setelah tulisan Could not resolve dependency adalah pemicunya.

Masalah Penyebab Solusi
Plugin minta React 17, proyek pakai 18 peer sempit, belum update Upgrade plugin atau downgrade React
ESLint 8 ditolak config lama config hanya dukung ESLint 7 Naikkan eslint-config atau tahan ESLint 7
Dua package minta versi berbeda rentang versi tidak irisan Cari versi tengah atau ganti salah satu package

Cara Memperbaiki Peer Dependency Error Langkah demi Langkah

Ikuti urutan ini agar tidak merusak lockfile:

  1. Catat konflik dari log. Lihat baris peer eslint@”…” from eslint-config-x.
  2. Cek pohon dependensi aktual dengan npm ls eslint react.
  3. Buka package.json dan lihat versi yang kamu pasang manual.
  4. Cek versi kompatibel yang tersedia sebelum mengubah apa pun.
  5. Pasang versi spesifik yang cocok, lalu lakukan install bersih.
npm view eslint-config-airbnb peerDependencies
npm ls react eslint
npm install eslint@8.57.0 --save-dev
npm install

Validasi dengan npm ls. Perintah itu harus selesai tanpa tulisan invalid atau ERESOLVE. Setelah bersih, hapus folder node_modules dan jalankan npm install ulang untuk memastikan lockfile konsisten.

Pakai –legacy-peer-deps hanya untuk proyek lama yang tidak diupdate dan butuh jalan cepat di CI. Jangan pakai –force untuk dependensi UI, React, atau ESLint karena versi yang dipaksa sering crash saat build. Keduanya bukan perbaikan permanen.

FAQ

Apakah –legacy-peer-deps aman dipakai?

Aman untuk darurat, tapi berisiko karena npm mengabaikan cek versi dan konflik bisa muncul saat runtime.

Haruskah hapus package-lock.json saat ERESOLVE?

Jangan hapus dulu. Perbaiki versi di package.json, karena menghapus lockfile justru menghilangkan versi yang sebelumnya terbukti jalan.

Kenapa error muncul setelah upgrade npm?

npm 7 ke atas menegakkan peerDependencies secara ketat, sedangkan npm 6 hanya memberi peringatan.