Поиск
Ошибки

npm: ERESOLVE unable to resolve dependency tree — конфликт версий пакетов

Один из пакетов проекта требует другую версию пакета, чем та, что уже стоит, и npm не может выполнить оба требования сразу. В сообщении написано, кто чего требует, — по нему и выбирают, что обновить.

≈ 5 мин чтения2 шага
Содержание 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.0npm собирал пакеты для вашего проекта 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 projectexample-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!. Затем запустите приложение или сборку и убедитесь, что они работают.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше