npm WindowsLinuxmacOSNode.jsnpm

npm: Как безопасно откатить проблемное обновление зависимости npm

  • Обновлено
  • Чтение ≈ 3 минуты

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

Когда обновление npm-пакета ломает сборку или работу приложения, безопасный откат должен восстановить согласованные package.json и package-lock.json, а не случайную смесь зависимостей. Особенно важно выяснить, применялись ли изменения базы или формата данных.

В этой статье
  1. Как проявляется ошибка и когда применим способ
  2. Причины и признаки
  3. Пошаговая диагностика и решение
  4. Проверка результата и действия при повторении

#Как проявляется ошибка и когда применим способ

Когда обновление npm-пакета ломает сборку или работу приложения, безопасный откат должен восстановить согласованные package.json и package-lock.json, а не случайную смесь зависимостей. Особенно важно выяснить, применялись ли изменения базы или формата данных.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Версия пакета изменила APIКод использует удалённую функцию или новый формат конфигурации.После обновления появляется воспроизводимая ошибка только в определённом сценарии.Вернуться к проверенному выпуску либо поправить использование API.
Откатывают не весь набор зависимостейИзменён только package.json, а package-lock.json остаётся с новым деревом.npm ci не проходит или устанавливается неподходящая комбинация.Восстановить оба файла из одной проверенной фиксации.

#Пошаговая диагностика и решение

  1. 1. Зафиксируйте момент поломкиОткройте журнал последнего успешного запуска и список изменений в Git. Сравните время обновления зависимостей с первым сбоем, выпишите пакет и фактический номер версии. Если изменения затрагивали данные или API внешнего сервиса, одного отката пакета может быть недостаточно.
  1. 2. Сохраните текущее состояние для анализаНа отдельной тестовой ветке сделайте копию package.json, package-lock.json и конфигурационных файлов. Проверьте git status, чтобы не потерять несохранённые правки. Не используйте git reset --hard на рабочем проекте и не редактируйте lock-файл вручную.
  2. Чтение состояния и истории изменений зависимостей; без прав администратора
    Linux · Терминал (Bash)Команда
    Чтение состояния и истории изменений зависимостей; без прав администратора.
    git status --short
    git log -5 --oneline -- package.json package-lock.json
  1. 3. Найдите последнюю проверенную фиксациюВ истории Git откройте конкретную фиксацию, где сборка проходила. Сравните версии зависимостей и настройки engines. Если такая фиксация есть, восстановите два файла в тестовой копии из неё, предварительно убедившись, что в текущей рабочей папке нет ценного несохранённого кода.
  1. 4. Восстановите согласованную пару файловВ отдельной ветке можно выполнить git restore --source=ХЕШ -- package.json package-lock.json, где ХЕШ — проверенная фиксация. Команда заменяет только эти два файла в текущей копии; убедитесь, что остальные новые зависимости не требуются изменённому коду.
  2. Дополнительная команда по теме
    Linux · Терминал (Bash)С осторожностью
    Замените ХЕШ реальным идентификатором; только в копии, перезаписывает содержимое двух файлов.
    git restore --source=ХЕШ -- package.json package-lock.json

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

  1. 5. Проведите чистую установкуВ тестовой копии выполните npm ci. Она удалит текущий node_modules и установит зафиксированные версии, не переписывая lock-файл. Если появляется ошибка совместимости, проверьте одновременно версию Node.js и настройки .npmrc.
  2. В отдельной копии; заменит node_modules и может выполнить установочные скрипты
    Linux · Терминал (Bash)С осторожностью
    В отдельной копии; заменит node_modules и может выполнить установочные скрипты.
    npm ci

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

  1. 6. Проверьте, что возвращены нужные версииВыполните npm ls ИМЯ_ПАКЕТА и тесты проекта. Проверьте сценарий, который ломался после обновления, и отдельно пройдите смежные сценарии, для которых пакет нужен. Если проблема не исчезла, не переносите этот откат на боевой сервер.
  2. Читает фактически установленные версии; замените имя пакета
    Linux · Терминал (Bash)Команда
    Читает фактически установленные версии; замените имя пакета.
    npm ls ИМЯ_ПАКЕТА
  1. 7. Перенесите откат штатным выпускомПосле успешного теста зафиксируйте восстановленные файлы отдельным коммитом и запустите согласованный выпуск приложения. При ошибках в рабочих данных откатывайте их только по проверенному плану восстановления; восстановление npm-пакета не отменяет миграции базы.

#Проверка результата и действия при повторении

После отката npm ci стабильно воспроизводит прежние версии, сборка и проблемный пользовательский сценарий выполняются. Если откат потребовал восстановления lock-файла и Node.js, фиксируйте оба условия в процедуре выпуска.

Если на указанном шаге результат отличается, остановитесь и запишите первое полное сообщение об ошибке, версию инструментов и проверенное состояние до исправления. Не переходите к опасным действиям на действующем проекте: повторите проверку на отдельной копии, верните сохранённые файлы и только затем выбирайте следующую причину.

Так эту ошибку тоже называют

npm ERR! ERESOLVE unable to resolve dependency tree — причины и решение Исправьте конфликт peer-зависимостей или используйте --legacy-peer-deps. Программирование и базы данных npm LinuxWindowsmacOS npm ERR! EACCES permission denied при глобальной установке — причины и решение Настройте префикс npm в домашней папке или используйте nvm; не используйте sudo. Программирование и базы данных npm LinuxWindowsmacOS npm ERR! code ELIFECYCLE — сбой скрипта — причины и решение ELIFECYCLE означает, что скрипт из package.json завершился с ошибкой. Прочитайте лог выше, удалите node_modules и lock-файл и повторите установку. Программирование и базы данных npm LinuxWindowsmacOS npm ERR! ETIMEDOUT и ECONNRESET — не загружаются пакеты — причины и решение Проверьте прокси, зеркало реестра и сеть. Программирование и базы данных npm LinuxWindowsmacOS 404 npm ERR! 404 Not Found — пакет не найден — причины и решение Пакет не существует, опечатка в имени или приватный реестр без авторизации. Проверьте имя и настройки реестра. Программирование и базы данных npm LinuxWindowsmacOS

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.