npm ERR! ERESOLVEの原因と直し方｜peer依存の読み方

ERESOLVE unable to resolve dependency tree は、インストールしようとしたパッケージが「このバージョンの○○と一緒に使ってください」（peer dependency）と指定している範囲と、プロジェクトに入っているバージョンが合わないときに出るエラーです。 npm 7 以降は、この食い違いを見つけるとインストールを止めます。

直し方は、上から順に検討します。

1. パッケージを、今のバージョンに対応した版（または後継のパッケージ）に変える（本来の直し方）
2. package.json の overrides で、どの版を使うかを明示する
3. --legacy-peer-deps で、peer dependency のチェックを外す（一時しのぎ）

この記事では、React 19 と ESLint 9 でエラーを実際に起こし、それぞれの直し方を試した結果を並べました。

確認環境：Node.js 22.22.2、npm 10.9.7（表記の比較に npm 9・10.0〜10.8・11.21 も使用）、React 19.3.0（確認日 2026年10月10日）。

エラー文の読み方

React 19 のプロジェクトに、React 17 までにしか対応していない @testing-library/react-hooks を入れました。

$ npm i @testing-library/react-hooks@8
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: a@1.0.0
npm error Found: react@19.3.0
npm error node_modules/react
npm error   react@"^19.3.0" from the root project
npm error
npm error Could not resolve dependency:
npm error peer react@"^16.9.0 || ^17.0.0" from @testing-library/react-hooks@8.0.1
npm error node_modules/@testing-library/react-hooks
npm error   @testing-library/react-hooks@"8" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.

「Found の版」と「peer の範囲」が重ならないのが原因です。この例では「React 19 が入っているのに、React 17 までのパッケージを入れようとした」と読めます。

npm ERR! と npm error は同じエラー

同じ操作を npm のバージョンを変えて実行すると、行頭の表記が変わりました。

内容は同じなので、どちらで検索しても、この記事の手順で直せます。

原因になりやすい組み合わせ

ESLint 9 に、ESLint 8 までに対応した設定パッケージを入れた結果です。

$ npm i -D eslint@9 eslint-config-airbnb-base
npm error Found: eslint@9.39.5
npm error Could not resolve dependency:
npm error peer eslint@"^7.32.0 || ^8.2.0" from eslint-config-airbnb-base@15.0.0

本体をメジャーバージョンアップした直後に、周辺のパッケージが追いついていない、というのがほとんどのケースです。

直し方1：対応した版・後継のパッケージに変える

まず、パッケージの peer dependency を、版ごとに確認します。

$ npm view @testing-library/react-hooks@8 peerDependencies
@testing-library/react-hooks@8.0.1 {
  react: '^16.9.0 || ^17.0.0',
  'react-dom': '^16.9.0 || ^17.0.0',
  ...
}

最新の版でも React 17 までなので、このパッケージは React 19 に対応していません。@testing-library/react-hooks の機能（renderHook）は @testing-library/react に取り込まれていて、こちらは React 19 に対応しています。

$ npm view @testing-library/react version peerDependencies
version = '16.3.3'
peerDependencies = {
  react: '^18.0.0 || ^19.0.0',
  'react-dom': '^18.0.0 || ^19.0.0',
  ...
}

対応した版が出ていれば、その版を入れるのが本来の直し方です。 出ていなければ、後継のパッケージを探すか、本体（React など）のバージョンアップを周辺が追いつくまで待つ判断になります。

直し方2：overrides で使う版を明示する

「本体の新しい版でも動くことを自分で確かめた」場合は、package.json の overrides で、そのパッケージが使う版を指定できます。$react は「package.json の dependencies に書いた react と同じ指定」という意味です。

{
  "dependencies": {
    "@testing-library/react-hooks": "^8.0.1",
    "react": "^19.3.0",
    "react-dom": "^19.3.0"
  },
  "overrides": {
    "@testing-library/react-hooks": {
      "react": "$react",
      "react-dom": "$react-dom"
    }
  }
}

$ npm i
added 6 packages, and audited 7 packages in 913ms

$ npm ls react
d@1.0.0
+-- @testing-library/react-hooks@8.0.1 overridden
| `-- react@19.3.0 deduped
+-- react-dom@19.3.0 overridden

エラーにならずに入り、npm ci でも同じ結果になりました。overrides は package.json に残るので、なぜ上書きしたかがチームで分かります。ただし、パッケージが React 19 で正しく動くかは保証されないため、テストで確かめます。

直し方3：--legacy-peer-deps と --force

エラー文にある2つのオプションは、動きが違います。

$ npm i @testing-library/react-hooks@8 --legacy-peer-deps
added 3 packages, and audited 7 packages in 676ms

$ npm ls react
+-- @testing-library/react-hooks@8.0.1
| `-- react@19.3.0 deduped invalid: "^16.9.0 || ^17.0.0" from node_modules/@testing-library/react-hooks

$ npm i @testing-library/react-hooks@8 --force
npm warn using --force Recommended protections disabled.
npm warn ERESOLVE overriding peer dependency
...
added 3 packages, and audited 7 packages in 1s

npm の公式ドキュメントでも、--force は「何をしたいかがはっきりしていなければ使わないことを強く勧める」とされています。どちらかを使うなら、影響が peer dependency の扱いに限られる --legacy-peer-deps のほうが分かりやすいです。

--legacy-peer-deps で入れると、npm ci で再発する

--legacy-peer-deps を付けて作った package-lock.json で、付けずに npm ci（CI や他の人の環境）を実行すると、同じエラーになりました。

$ npm ci
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: @testing-library/react-hooks@8.0.1
npm error Found: react@19.3.0
...
npm error Conflicting peer dependency: react@17.0.2

自分の PC では動いたのに CI で落ちるのは、このためです。使い続けるなら、プロジェクトの .npmrc に書いて、全員・CI で同じ設定にします。

# .npmrc（package.json と同じフォルダ）
legacy-peer-deps=true

.npmrc に書くと、以後すべてのパッケージで peer dependency のチェックが外れるため、別の食い違いにも気づけなくなります。対象のパッケージが限られているなら、直し方2の overrides のほうが影響を絞れます。

3つの直し方の比較

よくある質問

Q. npm install は通ったのに、npm ci だけ ERESOLVE になります。 A. package-lock.json を作ったときに --legacy-peer-deps か --force を付けていた可能性が高いです。.npmrc に設定を書くか、overrides に切り替えます。

Q. yarn や pnpm でも同じエラーになりますか。 A. 表示は違いますが、peer dependency の食い違いは同じように警告やエラーになります。原因（Found の版と peer の範囲が合わない）と、直し方の考え方は同じです。

Q. ERESOLVE could not resolve と ERESOLVE unable to resolve dependency tree の違いは何ですか。 A. 確認環境では、自分で直接入れようとしたパッケージで食い違うと unable to resolve dependency tree、package-lock.json の中の依存関係を解決する途中で食い違うと could not resolve になりました。読み方（Found と peer の行を比べる）は同じです。

Q. node_modules と package-lock.json を消して入れ直せば直りますか。 A. peer dependency の食い違いは、package.json に書いたバージョンの組み合わせの問題なので、消しても直りません。むしろ、それまで固定されていた版が変わって、別の問題が出ることがあります。

まとめ

• ERESOLVE は peer dependency の食い違い。Found: の版と peer ...@"範囲" を比べる
• npm ERR!（npm 10.5 まで）と npm error（10.6 以降）は同じエラー
• まず対応した版・後継のパッケージを探す。npm view パッケージ名 peerDependencies で確認
• 動作を確かめたなら overrides で明示。package.json に残るのでチームで再現できる
• --legacy-peer-deps をコマンドだけに付けると npm ci で再発。使うなら .npmrc に書く。--force は避ける

参考・出典

確認日はいずれも 2026年10月10日です。

• npm Docs「config（legacy-peer-deps・strict-peer-deps・force）」：https://docs.npmjs.com/cli/v10/using-npm/config#legacy-peer-deps
• npm Docs「package.json（overrides）」：https://docs.npmjs.com/cli/v10/configuring-npm/package-json#overrides

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。