Ошибки Node.js и npm: что значит сообщение и как его исправить
Когда Node.js или npm не может выполнить команду, он пишет сообщение об ошибке. Найдите его текст в таблицах ниже и откройте разбор — там написано, что значит сообщение и какие команды ввести. Здесь же — как читать остальные строки.
Содержание 10
Что сделать прямо сейчас
- Найдите первую строку ошибки: она начинается с типа ошибки, например
Error:,SyntaxError:илиReferenceError:, а у npm — сnpm ERR!. - Найдите похожий текст в таблицах ниже и откройте разбор.
- Если сообщения на экране нет, а приложение не работает, найдите его в журнале — где искать сообщение.
Команды на этой странице вводятся на сервере: подключитесь к нему по 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 memory | Node.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 нет такой команды |
Где искать сообщение
Если приложение запускали вручную, сообщение — прямо на экране, под командой. Если оно работает в фоне, сообщение — в журнале:
| Как запущено | Команда |
|---|---|
| служба systemd | sudo journalctl -u myapp -n 50 |
| PM2 | pm2 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.
Источники
- Документация Node.js 22: errors — вид первой строки ошибки и строк at; ошибка, которую не перехватило приложение, завершает процесс.
- Исходный код npm 9.2.0: lib/utils/exit-handler.js — строки code, syscall, path, errno и путь к журналу.
- Исходный код npm 10.9.4: lib/utils/display.js — префиксы npm error и npm warn.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Node.js на Ubuntuустановка и запуск приложения.
- Как установить PM2 на Ubuntuзапуск в фоне и перезапуск.
- Хостинг для Python и Node.jsчто выбрать под приложение.
- Все ошибки Python и pipто же для программ на Python.