npm installで出るERESOLVEエラーの直し方
ターミナルで npm install を実行して npm ERR! code ERESOLVE が出たら、入れようとしたパッケージが「一緒に使う相手」として求めるバージョンと、プロジェクトに入っているバージョンが合っていません。相手のパッケージも求められたバージョンに上げるか、入れるパッケージを今の版に合う版に下げると、エラーは消えます。
ライブラリのバージョンを上げたときや、React 向けのライブラリを追加したときに、パッケージどうしの対応バージョンが合わずにインストールが止まる場面で出るエラーです。私は検証環境で、react 18.3.1 が入ったプロジェクトに react-dom 19.2.9 を入れてこのエラーを起こし、メッセージの全文と、版を揃えると消えることを確かめました。
検証環境は Ubuntu 24.04 です。主に Node.js 22.23.4(npm 10.9.9)で試し、比べるために npm 9.9.4 と、Node.js 24.22.1 に付いてくる npm 11.19.1 でも同じ操作をしました。Windows と macOS、yarn や pnpm、peerDependencies 以外の原因で出る ERESOLVE は試していません。
エラーの全文と、行頭の違い
検証では、まず react@18.3.1 だけを入れたプロジェクトを作りました。package.json の dependencies は次のとおりです。
"dependencies": {
"react": "18.3.1"
}
ここで react-dom@19.2.9 を入れると、npm 10.9.9 では次のように出て止まりました(終了コードは1。パスは例示用の値に置き換えています)。
$ npm install react-dom@19.2.9 --no-audit --no-fund
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: app@1.0.0
npm error Found: react@18.3.1
npm error node_modules/react
npm error react@"18.3.1" from the root project
npm error
npm error Could not resolve dependency:
npm error peer react@"^19.2.9" from react-dom@19.2.9
npm error node_modules/react-dom
npm error react-dom@"19.2.9" 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.
npm error
npm error
npm error For a full report see:
npm error ~/.npm/_logs/2026-11-11T12_10_11_883Z-eresolve-report.txt
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-11T12_10_11_883Z-debug-0.log
npm ERR! code ERESOLVE と npm error code ERESOLVE は、行頭の書き方が違うだけで、同じエラーです。検証した中では、npm 9.9.4 で行頭が npm ERR! になりました。次は、同じ操作を npm 9.9.4 で行った出力です(パスは例示用の値に置き換えています)。行頭のほかに違うのは、While resolving: に出るプロジェクト名(検証用のフォルダー名)、ログのファイル名の日時、最後の行の前に空行が入ること、npm ERR! のあとに何もない行の末尾に空白が付くことだけです。
$ npx -y npm@9.9.4 install react-dom@19.2.9 --no-audit --no-fund
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR!
npm ERR! While resolving: app9@1.0.0
npm ERR! Found: react@18.3.1
npm ERR! node_modules/react
npm ERR! react@"18.3.1" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^19.2.9" from react-dom@19.2.9
npm ERR! node_modules/react-dom
npm ERR! react-dom@"19.2.9" from the root project
npm ERR!
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR!
npm ERR!
npm ERR! For a full report see:
npm ERR! ~/.npm/_logs/2026-11-11T12_10_22_469Z-eresolve-report.txt
npm ERR! A complete log of this run can be found in: ~/.npm/_logs/2026-11-11T12_10_22_469Z-debug-0.log
npm 10.9.9 と同じく、npm 11.19.1 でも行頭は npm error でした。npm 11.19.1 では、Fix the upstream dependency conflict, ... の3行が1行にまとめて出ました。
エラーで止まったあと、package.json は "react": "18.3.1" だけのままで、node_modules にも react-dom は入っていませんでした。
メッセージの読み方
メッセージは2つのかたまりに分かれていて、それぞれ「今あるもの」と「求められているもの」を示しています。
Found: の下は、今プロジェクトに入っている版です。react@18.3.1 が node_modules/react にあり、それは from the root project、つまり自分の package.json に書いたものだと分かります。
Could not resolve dependency: の下は、満たせなかった要求です。peer react@"^19.2.9" from react-dom@19.2.9 は、「react-dom 19.2.9 は、一緒に使う react として ^19.2.9(19.2.9 以上で 20 未満)を求めている」という意味です。18.3.1 はこの範囲に入らないので、npm はどちらも満たす組み合わせを作れずに止まりました。
この「一緒に使う相手」の指定が peerDependencies です。入れる前に、npm view で確かめられます。
$ npm view react-dom@19.2.9 peerDependencies
{ react: '^19.2.9' }
npm 公式ドキュメントの package.json のページにある、peerDependencies の説明によると、npm 3〜6 は peerDependencies を自動では入れず、合わない版があっても警告を出すだけでした。npm 7 からは peerDependencies も自動で入れるようになり、要求がぶつかって組み合わせを決められないときはエラーになることがある、と書かれています。
最後の For a full report see: のファイル(eresolve-report.txt)には、While resolving: から Fix the upstream ... までの部分が、npm error を外した形で書かれていました。ログのファイルは、npm のキャッシュの中の _logs に置かれます(Linux や macOS の既定は ~/.npm/_logs。検証環境でもここに置かれました)。
直し方:相手のバージョンを揃える
いちばん素直な直し方は、peer の行が求める版に、相手のパッケージを合わせることです。react を 19 に上げてよいなら、react と react-dom を同じコマンドで一緒に入れます。--save-exact は、package.json に ^ を付けずに版をそのまま書くオプションで、検証の版を固定するために付けました。
$ npm install react@19.2.9 react-dom@19.2.9 --save-exact --no-audit --no-fund
added 2 packages, removed 2 packages, and changed 1 package in 651ms
ERESOLVE は出ずに終わり(終了コードは0)、npm ls では2つの版が揃っていました(パスは例示用の値に置き換えています)。
$ npm ls
app@1.0.0 /path/to/app
+-- react-dom@19.2.9
`-- react@19.2.9
続けてもう一度 npm install を実行しても、up to date と出てエラーにはなりませんでした。react-dom を読み込んで <p>hello</p> を文字列にする小さなスクリプト(ssr.js)も、<p>hello</p> を表示して終わりました。
const React = require('react');
const { renderToString } = require('react-dom/server');
console.log(renderToString(React.createElement('p', null, 'hello')));
react を上げられないときは、逆に、入れるパッケージを今の react に合う版にします。react-dom 18.3.1 の peerDependencies は ^18.3.1 なので、react 18.3.1 と組み合わせられます。別のフォルダーに同じプロジェクトを作り直し、エラーで止まった状態(react 18.3.1 だけが入っている状態)から試しました(パスは例示用の値に置き換えています)。
$ npm install react-dom@18.3.1 --save-exact --no-audit --no-fund
added 2 packages in 673ms
$ npm ls
app18@1.0.0 /path/to/app18
+-- react-dom@18.3.1
`-- react@18.3.1
こちらもエラーは出ず、ssr.js は <p>hello</p> を表示しました。npm 11.19.1 でも、react と react-dom を 19.2.9 に揃えて一緒に入れると、エラーは出ずに入りました。
–legacy-peer-deps と –force で入れたときに起きたこと
メッセージには「--force か --legacy-peer-deps を付けて実行し直せば、正しくない(壊れているかもしれない)組み合わせを受け入れられる」とも書かれています。それぞれ付けて試したところ、エラーは消えましたが、合わない組み合わせがそのまま入りました。
--legacy-peer-deps を付けると、警告は出ずに入りました。--force を付けると、npm warn ERESOLVE overriding peer dependency から始まる警告が出たうえで入りました。どちらの場合も、npm ls react を実行すると、react が求められた範囲から外れていることが invalid と表示されました。次は --legacy-peer-deps で入れたときの出力です(--force でも同じ表示でした。パスは例示用の値に置き換えています)。
$ npm ls react
app@1.0.0 /path/to/app
+-- react-dom@19.2.9
| `-- react@18.3.1 deduped invalid: "^19.2.9" from node_modules/react-dom
`-- react@18.3.1 invalid: "^19.2.9" from node_modules/react-dom
npm error code ELSPROBLEMS
npm error invalid: react@18.3.1 /path/to/app/node_modules/react
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-11T12_10_16_507Z-debug-0.log
--legacy-peer-deps で入れた状態で ssr.js を実行すると、react-dom が版の食い違いを見つけて止まりました。次の出力では、Learn more: の行のあとに続くスタックトレースと Node.js v22.23.4 の行を省き、パスは例示用の値に置き換えています。
$ node ssr.js
/path/to/app/node_modules/react-dom/cjs/react-dom-server.node.development.js:8696
throw Error(
^
Error: Incompatible React versions: The "react" and "react-dom" packages must have the exact same version. Instead got:
- react: 18.3.1
- react-dom: 19.2.9
Learn more: https://react.dev/warnings/version-mismatch
--legacy-peer-deps で入れたあと、オプションを付けずに npm install を実行すると、また ERESOLVE で止まりました(ERESOLVE could not resolve と出ます)。エラーが消えても、食い違いはプロジェクトに残ったままです。
npm の設定の説明では、legacy-peer-deps は peerDependencies を完全に無視するもので、使うことは勧めないと書かれています。また、force はさまざまな保護を外すもので、何をしたいかがはっきりしていないなら使わないよう強く勧める、とも書かれています。エラーを消すために付けるのではなく、まず上の直し方で版を揃えることを考えてください。




