Node.js: Error: Cannot find module — модуль не найден
Node.js не нашёл пакет или файл, который подключает ваш код. На сервере так бывает после копирования проекта без папки node_modules, при запуске не из той папки и из-за опечатки в имени файла.
Содержание 7
Как выглядит ошибка
Если код подключает модули через require, сообщение такое:
Error: Cannot find module 'express'
Require stack:
- /home/ivan/myapp/app.js
at …
code: 'MODULE_NOT_FOUND',
requireStack: [ '/home/ivan/myapp/app.js' ]
}В кавычках — что не нашлось: имя пакета или путь к файлу. Под строкой Require stack — файл, который его подключал, а ниже — файлы, которые подключали этот файл.
Если не нашёлся сам файл, который вы запускаете, в кавычках будет полный путь к нему, а строк Require stack нет:
Error: Cannot find module '/home/ivan/app.js'Если код подключает модули через import, текст другой. Не установлен пакет:
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'express' imported from /home/ivan/myapp/app.jsНет файла по указанному пути. В Node.js 22 под первой строкой может стоять подсказка с правильным именем:
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/home/ivan/myapp/utils' imported from /home/ivan/myapp/app.js
Did you mean to import "./utils.js"?Шаг 1. Установите пакеты
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
Пакеты, от которых зависит проект, перечислены в файле package.json, а сами лежат в папке node_modules. Если вы скопировали проект без node_modules или забрали его из git, пакетов на сервере нет. Их ставит команда npm install в папке проекта:
cd /home/ivan/myapp
npm installЕсли пакета нет и в package.json, установите его по имени из сообщения — он добавится и в node_modules, и в package.json:
npm install expressЕсли npm пишет EACCES — разбор ошибки прав, если ERESOLVE — конфликт версий пакетов.
Шаг 2. Проверьте, из какой папки запускается приложение
Пакеты Node.js ищет в папке node_modules рядом с файлом, который их подключает, и в папках выше. А путь к главному файлу в команде node app.js считается от текущей папки. Поэтому node app.js, набранная в /home/ivan, а не в /home/ivan/myapp, даёт Cannot find module '/home/ivan/app.js'.
Перейдите в папку проекта и запустите приложение оттуда или укажите полный путь: node /home/ivan/myapp/app.js.
У службы systemd папку задаёт строка WorkingDirectory, а команду запуска — строка ExecStart. Посмотреть обе можно командой:
systemctl cat myappЕсли путь неверный, поправьте файл службы (sudo nano /etc/systemd/system/myapp.service) и примените правку:
sudo systemctl daemon-reload
sudo systemctl restart myappШаг 3. Проверьте имя файла и регистр букв
В Linux Utils.js и utils.js — разные файлы. На Windows и macOS регистр в именах файлов не различается, поэтому код, который работал на компьютере, на сервере может не найти файл. Сверьте имя из сообщения с тем, что лежит на диске, буква в букву:
ls /home/ivan/myappПри подключении через import расширение файла пишут полностью: не import { x } from './utils', а import { x } from './utils.js'. Без расширения Node.js файл не найдёт — это и есть случай с подсказкой Did you mean to import. Папку тоже не подключить через import './lib': указывайте файл — import './lib/index.js'.
Как проверить
Остановите службу и запустите приложение вручную из папки проекта — ошибка появляется сразу при запуске:
sudo systemctl stop myapp
cd /home/ivan/myapp
node app.jsЕсли ошибки нет, остановите приложение клавишами Ctrl+C и запустите службу снова: sudo systemctl start myapp. Последние строки её журнала покажет sudo journalctl -u myapp -n 50. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.
Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04.
Источники
- Исходный код Node.js 18.19.1: lib/internal/modules/cjs/loader.js — сообщение Cannot find module, строки Require stack, код MODULE_NOT_FOUND.
- Исходный код Node.js 22.22.1: lib/internal/errors.js — ERR_MODULE_NOT_FOUND: Cannot find package и Cannot find module.
- Исходный код Node.js 22.22.1: lib/internal/modules/esm/resolve.js — подсказка Did you mean to import.
- Документация Node.js 22: Modules — поиск пакетов в node_modules от папки файла вверх.
- Документация Node.js 22: ECMAScript modules — обязательное расширение файла в import, папку подключать нельзя.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Node.js на Ubuntuустановка и запуск службой.
- npm: EACCES permission deniedнет прав при установке пакетов.
- Команда journalctlкак читать журнал службы.
- Все ошибки Node.js и npmтаблица по тексту сообщения.
- User= и WorkingDirectory=папка, из которой служба запускает приложение.