Eresolve Bukan Jalan Buntu, Cara Mengatasi Npm Err Code Eresolve yang Aman

Error npm ERR! code ERESOLVE berarti npm versi 7 ke atas menolak install karena ada syarat peer dependency yang saling bertabrakan. Solusi amannya bukan langsung tambah flag, tapi baca baris Could not resolve dependency, lalu selaraskan versi package yang meminta peer berbeda.

Penyebab ERESOLVE di Proyek Node.js

Log ERESOLVE selalu menyebut package yang meminta versi peer tertentu, dan package lain yang sudah terpasang dengan versi berbeda. npm berhenti agar aplikasi tidak jalan dengan kombinasi yang belum tentu kompatibel.

Cek tiga titik ini sebelum mengubah apa pun: versi Node dengan node -v, versi npm dengan npm -v, lalu blok peerDependencies di package.json package yang bermasalah.

  • Konflik React: library meminta react@”^17″ sementara proyek memakai React 18.
  • Konflik ESLint: config atau plugin lama meminta eslint@”^7″ sementara proyek memakai ESLint 8 atau 9.
  • Plugin lama belum diperbarui: package tidak lagi dirawat dan peer-nya terkunci ke versi major lama.
  • Dependency transitif: konflik datang dari package bawaan library, bukan dari package yang kamu install langsung.

Tabel Diagnosis Cepat ERESOLVE

Perhatikan apakah konflik berasal dari package langsung atau dari dependency di dalamnya. Itu menentukan perbaikan yang tepat.

Pesan Log Penyebab Arah Solusi
peer react@”^17″ from library-A Proyek memakai React 18 Upgrade library-A atau turunkan React
peer eslint@”^7″ from eslint-plugin-X Plugin belum dukung ESLint 8/9 Cari versi plugin baru atau tahan versi ESLint
Conflicting peer dari dependency transitif Library membawa versi lama Gunakan overrides, bukan –force

Jangan pakai –force dan –legacy-peer-deps sebagai kebiasaan. Keduanya menyembunyikan konflik, bisa membuat build lolos tetapi runtime error, type mismatch, atau hook React ganda.

Cara Memperbaiki ERESOLVE Langkah per Langkah

  1. Baca log lengkap. Cari blok While resolving, Found, dan Could not resolve dependency.
  2. Petakan pohon dependency dengan perintah berikut.
  3. Cek versi tersedia yang kompatibel di registry npm.
  4. Selaraskan versi di package.json, atau paksa resolusi transitif lewat overrides untuk npm 8.3 ke atas.
  5. Hapus node_modules lalu install ulang tanpa menghapus lockfile bila memungkinkan.
npm install
npm ls react
npm ls eslint
npm view eslint-plugin-x peerDependencies version
{
  "overrides": {
    "react": "^18.2.0"
  }
}

Menghapus package-lock.json membuat seluruh versi dependency bisa bergeser. npm audit fix –force juga berisiko karena dapat menaikkan major version otomatis.

FAQ

Apakah –legacy-peer-deps aman untuk ERESOLVE?

Tidak untuk jangka panjang karena mengabaikan pemeriksaan peer dan bisa menimbulkan bug runtime.

Kapan harus downgrade package dibanding upgrade peer?

Downgrade bila plugin penting belum mendukung versi baru, upgrade bila library sudah menyediakan versi kompatibel.

Apakah perlu hapus node_modules dan package-lock.json?

Hapus node_modules kadang perlu, tetapi pertahankan package-lock.json kecuali seluruh dependency memang harus di-resolve ulang.