n1ro°
RU

Ошибки · Решение

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

Операция требует пустой каталог, но внутри ещё есть записи.

Редакция N1RO · Проверено

Короткий ответ

Node.js ENOTEMPTY — системная ошибка «Directory not empty». Для диагностики важнее всего поля error.syscall, error.path/address и контекст операции.

Что означает ошибка

Операция требует пустой каталог, но внутри ещё есть записи.

Возможные причины

  • Каталог удаляется нерекурсивным способом.
  • Фоновый процесс создаёт файлы во время cleanup.
  • Скрытые/временные файлы остаются после основной очистки.

Что проверить

  • Перечислите содержимое каталога непосредственно перед удалением.
  • Проверьте конкурентные writers.
  • Определите, должна ли операция вообще быть recursive.

Безопасные шаги

  1. Удаляйте известные дочерние объекты в контролируемом порядке.
  2. Остановите writer перед cleanup, если нужен гарантированно пустой каталог.
  3. Не включайте force/recursive, если содержимое может быть ценным.

Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.

Когда нужен сервис

  • Если Node.js ENOTEMPTY остаётся после проверки syscall и ресурса, приложите stack trace, error.syscall и связанные path/address/port владельцу сервиса или инфраструктуры.

Похожие ошибки

  • /errors/nodejs-eexist/
  • /errors/nodejs-eisdir/
  • /errors/nodejs-emfile/

Что учитывать

Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.

Официальный источник

Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.