#Что означает ошибка
ENOSPC
Лимит inotify исчерпан: слишком много наблюдаемых файлов. Увеличьте fs.inotify.max_user_watches и исключите node_modules.
#Причины и признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Малый лимит inotify | Linux достиг max_user_watches. | Сверьте лимит и число отслеживаемых файлов. |
| Много файлов | Каталог содержит тысячи ненужных файлов. | Исключите node_modules и результаты сборки. |
| Несколько watcher | Одновременно работают несколько наблюдателей. | Остановите ненужные dev-серверы. |
| IDE | IDE отслеживает все генерируемые файлы. | Измените список исключений редактора. |
#Пошаговое решение
- Подтвердите исчерпание наблюдателейОшибка
ENOSPC: System limit for number of file watchers reachedна Linux отличается от заполненного диска. Проверьте платформу командойuname -s; затем выполнитеcat /proc/sys/fs/inotify/max_user_watchesи посмотрите, сколько процессов наблюдают файлы. На Windows/macOS требуются другие способы диагностики. - Сократите лишнее наблюдениеВременно остановите ненужные dev-серверы, сборщики и редакторы, открыв Диспетчер задач или
psпо платформе. В настройках сборщика исключитеnode_modules,.git, каталог результатов сборки, если они попали в список наблюдения. Проверьте, что проект начинает отслеживать нужные исходники. - На Linux изменяйте лимит только при необходимостиЕсли нагрузка обоснованна и администратор согласовал увеличение, временно измените лимит через
sudo sysctl fs.inotify.max_user_watches=524288после оценки памяти. Для постоянной настройки используйте отдельный файл в/etc/sysctl.d/с именем и параметром, затемsudo sysctl --system; не применяйте это на чужом сервере без согласования. - Проверьте работу сборщикаЗаново запустите
npm run devили фактическую команду проекта; изменение одного исходного файла должно вызывать пересборку без ENOSPC. Если проблема вернулась, проверьте количество наблюдаемых папок, запущенных процессов и лимиты, а не просто умножайте значение на десять. - Текущий лимитLinux · Терминал (Bash)КомандаТекущий лимит.
cat /proc/sys/fs/inotify/max_user_watches
#Если проблема осталась
Если «Node.js: ENOSPC: System limit for number of file watchers reached» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.