npm: ERESOLVE unable to resolve dependency tree — конфликт версий пакетов
Один из пакетов проекта требует другую версию пакета, чем та, что уже стоит, и npm не может выполнить оба требования сразу. В сообщении написано, кто чего требует, — по нему и выбирают, что обновить.
Содержание 8
Как выглядит ошибка
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR!
npm ERR! While resolving: myapp@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@"^17.0.0" from example-widget@2.1.0
npm ERR! node_modules/example-widget
npm ERR! example-widget@"^2.1.0" 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.Ниже, после строки For a full report see:, npm пишет путь к полному отчёту — файлу, имя которого заканчивается на eresolve-report.txt, в папке ~/.npm/_logs. example-widget — условное имя, у вас будет свой пакет. Тексты сверены с исходным кодом npm 9.2.0 — эта версия ставится из пакетов Ubuntu 24.04 и 26.04 — и npm 10.9.4, который идёт вместе с Node.js 22.22.1 с сайта nodejs.org. В npm 10 строки начинаются с npm error вместо npm ERR!, а предупреждения — с npm warn вместо npm WARN.
Как читать сообщение
| Строка | Что значит |
|---|---|
While resolving: myapp@1.0.0 | npm собирал пакеты для вашего проекта myapp |
Found: react@18.3.1 | в проекте уже стоит или выбран react версии 18.3.1 |
react@"^18.3.1" from the root project | эту версию требует сам проект — она записана в его package.json |
peer react@"^17.0.0" from example-widget@2.1.0 | пакет example-widget версии 2.1.0 работает только с react 17 |
example-widget@"^2.1.0" from the root project | example-widget тоже подключён в package.json проекта |
Слово peer значит, что пакет не ставит react себе сам, а рассчитывает на тот, что уже есть в проекте. Знак ^ — «эта версия или новее в пределах того же первого числа»: ^17.0.0 подходит 17.0.2, но не 18.3.1.
Шаг 1. Найдите совместимую версию пакета
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
Посмотрите, с какими версиями работает последняя версия пакета из строки Could not resolve:
npm view example-widget peerDependenciesЕсли в ответе уже есть ваша версия — например react: '^17.0.0 || ^18.0.0', — обновите пакет до последней версии:
npm install example-widget@latestСписок всех версий пакета покажет npm view example-widget versions.
Шаг 2. Если совместимой версии нет
Тогда выбор такой: поставить в проект ту версию react, которую требует пакет, если код проекта с ней работает, или заменить пакет другим. Версию меняют в package.json и ставят командой npm install в папке проекта.
Флаги --legacy-peer-deps и --force
npm сам предлагает повторить команду с одним из флагов:
npm install --legacy-peer-depsС этим флагом npm не учитывает peer-зависимости вообще, как npm версий с 3 по 6: ошибки не будет, но пакет окажется рядом с версией, с которой его не проверяли, и может сломаться при запуске или сборке. С флагом --force npm тоже ставит пакеты вопреки конфликту. Оба флага подходят как временная мера, чтобы проверить приложение, а не как решение.
Если на компьютере проект ставился, а на сервере выдаёт ERESOLVE, сравните версии npm: npm -v. Если на компьютере стоит npm с 3 по 6, он не учитывает peer-зависимости, а npm новее их проверяет.
Как проверить
cd /home/ivan/myapp
npm installКоманда должна закончиться без строк npm ERR!. Затем запустите приложение или сборку и убедитесь, что они работают.
Источники
- Исходный код npm 9.2.0: lib/utils/explain-eresolve.js — строки While resolving, Found, Could not resolve dependency и совет про --force и --legacy-peer-deps.
- Исходный код npm 9.2.0: lib/utils/explain-dep.js — вид строк
пакет@"версия" from …и the root project. - Исходный код npm 9.2.0: lib/utils/error-message.js — код ERESOLVE и путь к отчёту eresolve-report.txt.
- Исходный код npm 9.2.0: build-ideal-tree.js — текст unable to resolve dependency tree.
- Исходный код npm 10.9.4: lib/utils/display.js — в npm 10 строки начинаются с
npm errorиnpm warn. - Документация npm 10: config — legacy-peer-deps: не учитывать peerDependencies, как в npm с 3 по 6.
Сверено 22 октября 2026 года.
Что почитать дальше
- npm: EBADENGINEпакет требует другую версию Node.js.
- Cannot find moduleпакет не установлен.
- Все ошибки Node.js и npmтаблица по тексту сообщения.