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 barisFounddanCould not resolve. - Hasil
npm ls nama-packageuntuk melihat siapa meminta versi apa. - Blok
dependenciesdanpeerDependenciesdi 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.0padahal 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
- Cek pohon dependency dengan perintah berikut untuk menemukan sumber konflik.
- Update package yang konflik secara selektif, jangan update semua sekaligus.
- Paksa satu versi lewat
overridesbila dua library ngotot meminta versi berbeda. - 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.