Cek Konflik Dulu sebelum Cara Mengatasi Npm Legacy Peer Deps

Cara mengatasi npm legacy peer deps yang aman adalah membaca pesan ERESOLVE dulu, menyelaraskan versi package yang bentrok, lalu install ulang bersih. Flag --legacy-peer-deps memang membuat npm install jalan, tetapi konflik versi tetap ada di folder node_modules dan bisa memicu error runtime.

Kenapa Error ERESOLVE Memicu Legacy Peer Deps

npm versi 7 ke atas memasang peerDependencies secara otomatis dan menolak instalasi kalau rentang versinya tidak cocok. Package lama sering meminta React 17 sementara proyek sudah memakai React 18, atau plugin ESLint meminta TypeScript yang berbeda dari versi terpasang.

Perintah dengan flag tersebut hanya menyuruh npm mengabaikan pemeriksaan itu. Instalasi selesai, tetapi dua versi library bisa tercampur. Dampaknya umum:

  • Aplikasi React error hooks invalid atau duplikat React.
  • Build gagal karena API TypeScript berubah.
  • Lint atau test berperilaku beda antara komputer developer dan server.

Tabel: Pesan Error, Penyebab, dan Respons Aman

Masalah Penyebab Solusi
ERESOLVE could not resolve Rentang peer tidak bertemu Selaraskan versi di package.json
Conflicting peer dependency Plugin meminta versi lama Update plugin atau cari pengganti
Instalasi lolos, runtime error Flag menutupi konflik asli Hapus flag, perbaiki versi

Langkah Cara Memperbaiki Tanpa Merusak Proyek

Jalankan diagnosis sebelum menghapus file lock atau memakai flag berisiko.

  1. Cek versi Node dan npm, lalu lihat pohon peer yang bermasalah.
    node -v
    npm -v
    npm ls react
    npm ls eslint
  2. Baca blok ERESOLVE sampai ketemu baris Found dan peer ... from .... Catat package mana yang meminta versi lama.
  3. Perbaiki sumbernya dulu. Update package yang tertinggal, turunkan versi library utama bila memang belum didukung, atau ganti plugin yang sudah tidak dirawat.
  4. Lakukan install ulang bersih setelah package.json konsisten.
    rm -rf node_modules
    npm cache verify
    npm install
  5. Kalau terpaksa memakai flag untuk lanjut kerja, catat sebagai utang teknis. Untuk pin versi tertentu, pakai overrides di npm v8.3 ke atas.
    {
      "overrides": {
        "react": "18.2.0"
      }
    }

Pakai --force hanya bila paham risikonya karena npm akan menimpa konflik tanpa validasi. Jangan jadikan npm audit fix --force sebagai kebiasaan karena perintah itu dapat menaikkan versi mayor secara tak terduga.

FAQ

Apakah –legacy-peer-deps aman dipakai harian?

Tidak. Cocok untuk darurat lokal, tetapi konflik yang disembunyikan bisa meledak saat build production.

Haruskah hapus package-lock.json dan node_modules?

Hapus node_modules boleh untuk install bersih, sedangkan package-lock.json hapus hanya bila file lock rusak dan versi package sudah dikunci.

Kapan update package lebih baik daripada pakai flag?

Selalu dahulukan update ketika maintainer sudah merilis versi yang mendukung peer baru, flag hanya opsi terakhir.