ERESOLVE node dependency_error ai_generated true

npm error ERESOLVE could not resolve peer dependency conflict

ID: node/npm-peer-deps-conflict

Also available as: JSON · Markdown
88%Fix Rate
90%Confidence
50Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
20 active — — —

Root Cause

Two packages require incompatible versions of a shared dependency.

generic

Workarounds

  1. 88% success Use --legacy-peer-deps to use npm v6 resolution (less strict) 
    npm install --legacy-peer-deps

    Sources: https://docs.npmjs.com/cli/v10/commands/npm-install#legacy-peer-deps

  2. 90% success Check which packages conflict and update them: npm ls <dep> 
    npm ls <dep>

    Sources: https://docs.npmjs.com/cli/v10/commands/npm-ls

  3. 82% success Add overrides in package.json to force a specific version 
    { "overrides": { "conflicting-pkg": "^2.0.0" } }

    Sources: https://docs.npmjs.com/cli/v10/configuring-npm/package-json#overrides

Dead Ends

Common approaches that don't work:

  1. Use --force flag 65% fail

    Installs potentially broken dependencies — may cause runtime errors

  2. Delete package-lock.json and reinstall 60% fail

    Lock file protects reproducibility — deleting it may introduce other issues

Error Chain

Frequently confused with: