Поиск
Ошибки

Ошибки Node.js и npm: что значит сообщение и как его исправить

Когда Node.js или npm не может выполнить команду, он пишет сообщение об ошибке. Найдите его текст в таблицах ниже и откройте разбор — там написано, что значит сообщение и какие команды ввести. Здесь же — как читать остальные строки.

≈ 5 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Найдите первую строку ошибки: она начинается с типа ошибки, например Error:, SyntaxError: или ReferenceError:, а у npm — с npm ERR!.
  2. Найдите похожий текст в таблицах ниже и откройте разбор.
  3. Если сообщения на экране нет, а приложение не работает, найдите его в журнале — где искать сообщение.

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

Как читать сообщение

СтрокаЧто значит
Error: …, SyntaxError: …тип ошибки и её текст — по нему ищите в таблицах
at …где в коде возникла ошибка: файл, номер строки и номер символа
code: '…' в фигурных скобкахподробности: код ошибки, адрес, порт, путь
(node:1234) Warning: …предупреждение Node.js; число — номер процесса
npm ERR! …npm не выполнил команду
npm WARN …предупреждение npm: команда выполняется дальше

Если приложение не перехватило ошибку, Node.js завершает программу. Сайт на ней перестаёт открываться; если перед ним стоит nginx, он показывает 502 Bad Gateway.

В строках at ищите первый путь к файлу вашего проекта, например /home/ivan/myapp/app.js:12:5 — это файл app.js, строка 12, символ 5; строки с node:internal относятся к самому Node.js.

В npm 10 строки начинаются с npm error и npm warn вместо npm ERR! и npm WARN, смысл тот же. В конце ошибки npm пишет путь к журналу: строка A complete log of this run can be found in:, ниже — путь к файлу в папке ~/.npm/_logs.

Запуск приложения и порты

СообщениеЧто значит
Error: listen EADDRINUSE: address already in useпорт уже занят другой программой или второй копией приложения
Error: listen EACCES: permission denied 0.0.0.0:80порты с номерами меньше 1024 может открыть только root
Error: Cannot find module '…'Node.js не нашёл файл или пакет: не та папка или пакеты не установлены
Error: connect ECONNREFUSED 127.0.0.1:5432база или другая служба не принимает подключения на этом порту

Модули: import и require

СообщениеЧто значит
SyntaxError: Cannot use import statement outside a moduleв файле import, а Node.js читает его как CommonJS
ReferenceError: require is not defined in ES module scopeв файле require, а Node.js читает его как ES-модуль
Error [ERR_REQUIRE_ESM]: require() of ES Moduleпакет подключают через require, а он есть только как ES-модуль

Память

СообщениеЧто значит
FATAL ERROR: … JavaScript heap out of memoryNode.js упёрся в свой лимит памяти
Out of memory: Killed processна сервере кончилась память, и ядро остановило программу; эта строка — в журнале ядра, а не в выводе Node.js

npm: установка пакетов и команды

СообщениеЧто значит
npm ERR! code EACCESнет прав на папку, куда npm ставит пакеты
npm ERR! code ERESOLVEверсии пакетов не подходят друг другу
npm WARN EBADENGINE Unsupported engineпакету нужна другая версия Node.js или npm
npm ERR! Missing scriptв package.json нет такой команды

Где искать сообщение

Если приложение запускали вручную, сообщение — прямо на экране, под командой. Если оно работает в фоне, сообщение — в журнале:

Как запущеноКоманда
служба systemdsudo journalctl -u myapp -n 50
PM2pm2 logs myapp --lines 50

myapp — имя службы или приложения в PM2, подставьте своё. Подробнее — команда journalctl и как установить PM2.

Откуда тексты

Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04. Тексты сверены с исходным кодом 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. Свою версию покажут команды node -v и npm -v.

Источники

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

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

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