Ошибки · Решение
Node.js ENOTEMPTY: что означает ошибка и как исправить
Операция требует пустой каталог, но внутри ещё есть записи.
Короткий ответ
Node.js ENOTEMPTY — системная ошибка «Directory not empty». Для диагностики важнее всего поля error.syscall, error.path/address и контекст операции.
Что означает ошибка
Операция требует пустой каталог, но внутри ещё есть записи.
Возможные причины
- Каталог удаляется нерекурсивным способом.
- Фоновый процесс создаёт файлы во время cleanup.
- Скрытые/временные файлы остаются после основной очистки.
Что проверить
- Перечислите содержимое каталога непосредственно перед удалением.
- Проверьте конкурентные writers.
- Определите, должна ли операция вообще быть recursive.
Безопасные шаги
- Удаляйте известные дочерние объекты в контролируемом порядке.
- Остановите writer перед cleanup, если нужен гарантированно пустой каталог.
- Не включайте force/recursive, если содержимое может быть ценным.
Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.
Когда нужен сервис
- Если Node.js ENOTEMPTY остаётся после проверки syscall и ресурса, приложите stack trace, error.syscall и связанные path/address/port владельцу сервиса или инфраструктуры.
Похожие ошибки
- /errors/nodejs-eexist/
- /errors/nodejs-eisdir/
- /errors/nodejs-emfile/
Что учитывать
Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.
Официальный источник
Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.