Peer Deps Bentrok? Begini Cara Mengatasi Npm Dependency Conflict

Cara mengatasi npm dependency conflict yang paling aman adalah membaca pesan ERESOLVE sampai tuntas, lalu menyelaraskan versi package yang diminta peer dependency. Jangan langsung memakai –force, –legacy-peer-deps, atau menghapus package-lock.json. Perintah itu menyembunyikan konflik, bukan memperbaikinya.

Penyebab Umum Dependency Conflict di Npm

Npm versi 7 ke atas memasang peer dependency secara otomatis. Kalau dua package meminta versi induk yang berbeda, instalasi berhenti dengan kode ERESOLVE. Ini berbeda dengan konflik transitif biasa yang masih bisa diselesaikan npm dengan menaruh dua salinan di folder berbeda.

Baca tiga tempat ini sebelum bertindak:

  • Output npm install, terutama baris Found dan Could not resolve.
  • Hasil npm ls nama-package untuk melihat siapa meminta versi apa.
  • Blok dependencies dan peerDependencies di package.json.

Pemicu yang paling sering muncul:

  • Major version berbeda, misalnya React 17 diminta satu library dan React 18 diminta library lain.
  • Peer range terlalu sempit, misalnya plugin hanya menerima ^4.0.0 padahal proyek sudah memakai versi 5.
  • Lockfile kedaluwarsa setelah update satu package tanpa update pasangannya.
  • Package lama yang belum mendukung versi baru framework.

Tabel Diagnosis Cepat ERESOLVE Npm

Jangan hapus lockfile atau folder node_modules sebelum diagnosis selesai. Penghapusan membuat riwayat versi hilang dan konflik lebih sulit dilacak.

Pesan Error Penyebab Arah Solusi
Could not resolve peer react@”17″ Plugin lama belum dukung React 18 Turunkan React atau cari plugin pengganti
Found: eslint@9, plugin needs eslint@8 Major version linter berubah Selaraskan versi eslint semua plugin
Fix the upstream conflict Dua package minta versi induk beda Update selektif atau pakai overrides

Hati-hati dengan jalan pintas. Opsi --force dan --legacy-peer-deps memaksa instalasi tanpa memeriksa kecocokan peer. Proyek bisa jalan lalu error saat runtime. Perintah npm audit fix --force juga berisiko karena dapat menaikkan major version tanpa persetujuan.

Cara Memperbaiki Conflict Tanpa Merusak Proyek

  1. Cek pohon dependency dengan perintah berikut untuk menemukan sumber konflik.
  2. Update package yang konflik secara selektif, jangan update semua sekaligus.
  3. Paksa satu versi lewat overrides bila dua library ngotot meminta versi berbeda.
  4. Lakukan instalasi bersih setelah versi selaras, lalu verifikasi ulang.
npm ls react
npm install eslint@8.57.0
npm install

Contoh overrides di package.json untuk proyek npm:

{
  "overrides": {
    "semver": "^7.5.0"
  }
}

Verifikasi dengan npm ls. Pastikan tidak ada baris invalid atau unmet peer. Jalankan ulang npm install dari kondisi bersih hanya setelah versi dipastikan cocok.

FAQ

Kapan boleh pakai –legacy-peer-deps?

Boleh untuk kebutuhan sementara saat plugin belum update, selama aplikasi diuji penuh setelah instalasi.

Apakah aman hapus package-lock.json?

Tidak aman sebagai langkah pertama karena versi terkunci ikut hilang dan konflik baru bisa muncul.

Kenapa ERESOLVE muncul setelah update satu package?

Package baru meminta peer versi baru, sedangkan package lain di proyek masih mengunci versi lama.