npm LinuxWindowsmacOS

npm ERR! code EINTEGRITY — ошибка контрольной суммы

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

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

Повреждённый кэш или изменённый lock-файл вызывают EINTEGRITY. Очистите кэш npm и переустановите зависимости.

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

#Что означает ошибка

Сообщение
EINTEGRITY

Повреждённый кэш или изменённый lock-файл вызывают EINTEGRITY. Очистите кэш npm и переустановите зависимости.

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

Возможная причинаКак узнатьЧто делать
Битый кэшВ кэше не совпадают метаданные пакета.Выполните npm cache verify.
Изменён lockLock-файл и реестр расходятся по integrity.Сверьте происхождение и версию, не удаляйте lock вслепую.
Сбой сетиЗагрузка архива оборвалась.Проверьте соединение и повторите с тем же реестром.
ПроксиПрокси или зеркало изменяет содержимое.Сверьте integrity с официальным registry и администратором.

#Пошаговое решение

  1. Сохраните сведения о повреждённом пакетеПри npm ERR! EINTEGRITY скопируйте название пакета, требуемую и полученную суммы integrity из вывода. В терминале корня проекта проверьте npm --version и npm config get registry; в организации реестр может быть внутренним зеркалом.
  2. Проверьте кэш без удаления lock-файлаВыполните npm cache verify. Команда проверяет и при необходимости очищает повреждённые записи кэша. Затем повторите прежнюю установку (npm ci для проекта с согласованным package-lock.json). Не удаляйте package-lock.json и не отключайте сверку integrity.
  3. Сравните реестр и сведения о пакетеЕсли ошибка осталась, проверьте метаданные проблемной версии через npm view ИМЯ_ПАКЕТА@ВЕРСИЯ dist.integrity --registry=https://registry.npmjs.org/, подставив реальные имя и версию. Сопоставьте с lock-файлом и вашим доверенным зеркалом; расхождение на корпоративном прокси передайте администратору, не скачивайте архив с непроверенного сайта.
  4. Проверьте повторную установкуУспех — завершение установки без EINTEGRITY и сохранённый lock-файл; затем запустите тесты проекта. Если повторяется несовпадение, сохраните логи npm и адрес реестра без токенов. npm cache clean --force используйте только после установленной причины, а не как универсальный обход.
  5. Очистка кэша npm
    Linux · Терминал (Bash)Команда
    Очистка кэша npm.
    npm cache verify

#Если проблема осталась

Если «npm ERR! code EINTEGRITY — ошибка контрольной суммы» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

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

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

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