Ошибка «mongodump не является внутренней или внешней командой, исполняемой программой или пакетным файлом» появляется в командной строке Windows, когда система не находит исполняемый файл mongodump.exe — ни в текущей папке, ни в каталогах, перечисленных в переменной окружения PATH. Это не сбой самой MongoDB: сервер базы данных при этом может работать нормально.
Чаще всего причина одна из двух: утилиты MongoDB Database Tools (куда входят mongodump, mongorestore, mongoexport и другие) вообще не установлены на компьютере, либо путь к папке с ними не прописан в PATH. Начиная с определённых версий MongoDB эти инструменты перестали входить в состав основного установщика сервера и распространяются отдельным пакетом — именно поэтому ошибка так часто возникает у пользователей, которые установили сам сервер, но не знали про отдельные утилиты.
Почему Windows не находит mongodump
Командная строка ищет исполняемый файл в строго определённых местах: сначала в текущем каталоге, затем во всех папках, перечисленных в переменной PATH. Если mongodump.exe нет ни в одном из них, выводится именно сообщение «не является внутренней или внешней командой».
Типичные сценарии, приводящие к ошибке:
- 🔧 Утилиты не установлены — Database Tools скачиваются отдельно от сервера MongoDB, и многие об этом не знают.
- 📁 Путь не добавлен в PATH — файлы лежат на диске, но система о них не знает.
- 🔄 Терминал не перезапущен — после изменения PATH уже открытые окна командной строки продолжают использовать старые значения переменных.
- ✏️ Опечатка в пути или имени команды — лишний пробел или неверная буква дают тот же результат.
⚠️ Внимание: если вы запускаете команду из PowerShell, а файл лежит в текущей папке, указывайте его как .\mongodump.exe — PowerShell по умолчанию не ищет исполняемые файлы в текущем каталоге без явного префикса.
Шаг 1. Проверьте, установлены ли MongoDB Database Tools
Прежде чем что-то настраивать, убедитесь, что файл вообще существует на диске. Откройте проводник и поищите mongodump.exe в типичных местах установки:
- 📂
C:\Program Files\MongoDB\Tools\...— стандартное расположение пакета Database Tools; - 📂
C:\Program Files\MongoDB\Server\<версия>\bin— здесь утилиты находились в старых версиях, когда они входили в состав сервера; - 📂 Папка, куда вы вручную распаковывали архив с утилитами.
Быстрый способ проверки — выполнить в командной строке поиск по диску, но проще воспользоваться проводником. Если файл mongodump.exe найден, запишите полный путь к папке, где он лежит, — он понадобится на следующем шаге. Если файла нет нигде, переходите к разделу про установку.
Шаг 2. Установите MongoDB Database Tools
Если утилит на компьютере нет, их нужно скачать с официального сайта MongoDB как отдельный пакет MongoDB Database Tools. Доступны два варианта распространения: MSI-установщик и ZIP-архив. Установщик сам размещает файлы и обычно предлагает добавить путь в PATH автоматически; при использовании архива распакуйте его в удобную папку, например C:\mongodb-tools, и запомните путь к подпапке bin.
После установки проверьте, где оказался mongodump.exe. Именно папка, содержащая этот файл, должна попасть в PATH — не корень пакета и не папка Tools, а именно каталог с самими исполняемыми файлами.
Шаг 3. Добавьте путь к mongodump в переменную PATH
Это ключевой шаг, который решает проблему в большинстве случаев. Порядок действий в Windows 10 и 11 одинаков:
Откройте Параметры → Система → О системе → Дополнительные параметры системы (или нажмите Win + R и введите sysdm.cpl). На вкладке «Дополнительно» нажмите кнопку «Переменные среды». В списке системных или пользовательских переменных найдите Path, выделите её и нажмите «Изменить». Затем нажмите «Создать» и вставьте полный путь к папке с утилитами, например:
C:\Program Files\MongoDB\Tools\100\binТочный путь зависит от версии пакета и способа установки — сверяйте его с реальным расположением файла, которое вы нашли на первом шаге. Сохраните изменения, нажимая «ОК» во всех окнах.
☑️ Добавление mongodump в PATH
⚠️ Внимание: после изменения PATH обязательно закройте и заново откройте командную строку, PowerShell или терминал IDE — уже открытые окна не подхватывают новые значения переменных окружения. Это самая частая причина, по которой «ничего не помогло».
Шаг 4. Проверьте работу команды
Откройте новое окно командной строки и выполните:
mongodump --versionЕсли вместо ошибки выводится информация о версии утилиты — настройка завершена, можно создавать резервные копии. Для проверки полного цикла выполните тестовый дамп локальной базы:
mongodump --uri="mongodb://localhost:27017" --out=C:\backupЕсли команда снова не находится, вернитесь к первому шагу и сравните путь в PATH с реальным расположением файла посимвольно. Лишний слеш, отсутствующая подпапка bin или путь к старой версии — типичные ошибки. Также убедитесь, что вы редактировали ту же переменную Path, которая действует для вашего пользователя: изменения в пользовательском разделе не влияют на процессы, запущенные от имени другого пользователя или системы.
Как временно запустить mongodump без изменения PATH
Откройте командную строку и перейдите в папку с утилитой командой cd, например: cd "C:\Program Files\MongoDB\Tools\100\bin" — после этого mongodump будет запускаться из текущего каталога. Либо указывайте полный путь к файлу в каждой команде. Это удобно для разовой операции, но для постоянной работы лучше настроить PATH.
Типичные причины и способы устранения: сводная таблица
Для быстрой диагностики используйте таблицу ниже — найдите свою ситуацию и сразу переходите к нужному решению.
| Симптом | Вероятная причина | Решение |
|---|---|---|
| Файл mongodump.exe не найден на диске | Database Tools не установлены | Скачать и установить пакет с официального сайта |
| Файл есть, но команда не находится | Папка bin не добавлена в PATH | Добавить путь через «Переменные среды» |
| PATH изменён, но ошибка осталась | Терминал не был перезапущен | Закрыть и заново открыть командную строку |
| Работает в cmd, но не в PowerShell | Запуск из текущей папки без префикса | Использовать .\mongodump.exe или полный путь |
| Команда работает, но не подключается к базе | Сервер MongoDB не запущен или неверная строка подключения | Проверить службу MongoDB и параметр --uri |
Если ошибка появляется в других средах
Аналогичная проблема возникает не только в классической командной строке. В PowerShell логика поиска та же, но действует правило с префиксом .\ для текущего каталога. В терминале VS Code после изменения PATH помогает не просто открытие новой вкладки терминала, а полный перезапуск редактора, поскольку он наследует переменные окружения при старте.
Отдельный случай — запуск из скриптов, планировщика задач или CI/CD. Такие процессы могут работать под другой учётной записью и не видеть пользовательскую переменную PATH. Надёжное решение — указывать в скриптах полный путь к mongodump.exe или добавлять путь в системную, а не пользовательскую переменную Path.
Часто задаваемые вопросы
Почему mongodump не установился вместе с сервером MongoDB?
Начиная с определённых версий MongoDB, утилиты командной строки (mongodump, mongorestore, mongoexport и др.) вынесены в отдельный пакет MongoDB Database Tools. Их нужно скачивать и устанавливать отдельно с официального сайта.
Я добавил путь в PATH, но ошибка не исчезла. Что делать?
Полностью закройте все окна командной строки, PowerShell и IDE, затем откройте терминал заново — открытые процессы не обновляют переменные окружения. Если не помогло, сверьте путь в PATH с реальным расположением mongodump.exe посимвольно.
Можно ли пользоваться mongodump без добавления в PATH?
Да. Перейдите в папку с утилитой командой cd и запускайте её оттуда, либо указывайте полный путь к mongodump.exe в каждой команде. Для регулярной работы удобнее всё же настроить PATH.
Как проверить, что mongodump установлен и работает?
Откройте новое окно командной строки и выполните команду mongodump --version. Если выводится номер версии утилиты — всё настроено правильно.
Команда запускается, но не может подключиться к базе. Это та же ошибка?
Нет. Если mongodump запускается, проблема с PATH решена. Ошибка подключения означает, что сервер MongoDB не запущен или указана неверная строка подключения в параметре --uri. Проверьте состояние службы MongoDB и параметры подключения.