n1ro°
RU

Ошибки и коды · Инструкция

npm WARN EBADENGINE / Unsupported engine

Выполните `node -v` и `npm -v` в той же shell/CI, где появляется warning/error. Найдите в сообщении package и требуемый

Редакция N1RO · Проверено

Короткий ответ

Сравните `node -v` и `npm -v` с полем `engines` проблемного package; переключите runtime на поддерживаемую версию и переустановите зависимости, а не игнорируйте несовместимость вслепую.

Проверка по порядку

  • Выполните `node -v` и `npm -v` в той же shell/CI, где появляется warning/error.
  • Найдите в сообщении package и требуемый диапазон `engines`.
  • Проверьте `engines` корневого проекта и `.nvmrc`/`.node-version`/CI image.

Исправление

  1. Переключитесь на версию Node, которая удовлетворяет и проекту, и проблемной зависимости.
  2. Под выбранным runtime запустите чистый `npm ci`.
  3. Запустите тесты и зафиксируйте runtime в dev/CI setup, чтобы окружения не расходились.

Как понять, что исправлено

  • node -v удовлетворяет engines, чистый npm ci проходит без EBADENGINE для проблемного package и приложение/тесты запускаются.

Важно

Не подавляйте EBADENGINE флагами, пока не проверили совместимость. Успешная установка не гарантирует работу пакета на неподдерживаемом Node.

Что учитывать

Не подавляйте EBADENGINE флагами, пока не проверили совместимость. Успешная установка не гарантирует работу пакета на неподдерживаемом Node.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. package.json). Пример и формулировки — редакция N1RO на 2026-09-17.