Устранение неполадок Zinnector®

Реальные ошибки, с которыми пользователи сталкиваются при работе с CLI-интерфейсом Zinnector®, значение каждой из них и способы их устранения. В каждой записи указан точный текст, который вы увидите, поэтому вы можете найти его на этой странице. Если вашей ошибки здесь нет, запустите неработающую команду с параметром ZINNECTOR_DEBUG=1 и отправьте сообщение об ошибке на странице github.com/Zinn-Digital/zinnector/issues, приложив вывод команды, а также информацию о вашей версии Node (node --version) и операционной системе.

Ошибка «spawn EINVAL» сразу после принятия установки среды выполнения (Windows)

Ошибка в Zinnector® 0.1.0 и 0.1.1. В ОС Windows установщик среды выполнения запускал npm.cmd по имени, а Node стал отказываться от запуска файлов .cmd без использования оболочки (shell) после устранения уязвимости CVE-2024-27980, поэтому установка завершалась сбоем через секунду после ответа Y. Исправлено в версии 0.1.2: теперь npm запускается как node npm-cli.js, что работает одинаково на любой платформе и не требует оболочки. Выполните команду npm install -g zinnector@latest, а затем снова запустите zinnector dev.

Предупреждение «npm WARN EBADENGINE» во время установки либо сообщение «Zinnector® needs Node 24 or newer»

Используемая вами версия Node устарела (требуется версия 24 или новее). npm выводит это предупреждение, поскольку в пакете указано значение engines: >=24.18.1; установка при этом завершается, однако zinnector впоследствии отказывается запускаться (код выхода 78), чтобы предотвратить появление непонятных ошибок в дальнейшем. Установите текущую долгосрочную версию (LTS) с сайта nodejs.org (команда winget install OpenJS.NodeJS.LTS для Windows или brew install node@24 для macOS), убедитесь, что команда node --version возвращает версию v24 или выше, и повторите установку Zinnector®.

Сообщения «gyp ERR!», «Building from source with node-gyp» или «You need to install Visual Studio»

Среда выполнения WordPress содержит собственный модуль, готовые двоичные файлы (бинарники) которого существуют только для Node 24 и 25. На более новых версиях Node (26 и выше, по состоянию на сентябрь 2026 года) её установщик переключается на сборку из исходного кода, что на обычном компьютере под управлением Windows приводит к запросу на установку Visual Studio. Исправлено в версии 0.1.2: Zinnector® определяет это перед загрузкой любых файлов и скачивает версию Node 24 исключительно для работы среды выполнения (около 30 МБ, проверка подлинности выполняется по контрольным суммам с nodejs.org), поэтому компиляция из исходного кода не требуется. Если после обновления ошибка по-прежнему воспроизводится, выполните команду zinnector dev --reset-runtime, чтобы предварительно удалить незавершённую установку.

Предупреждения «EPERM» от npm во время очистки (Windows)

Почти всегда это означает, что антивирус или служба индексирования поиска удерживают файл открытым в папке node_modules среды выполнения, в то время как npm пытается его удалить. Повторная попытка установки будет выполнена из чистой директории при следующем запуске zinnector dev; если ошибка повторяется, команда zinnector dev --reset-runtime сначала полностью удалит директорию среды выполнения, а затем выполнит установку заново.

Ошибка «the local playground runtime could not be installed»

Это сообщение содержит последние строки вывода npm и точную команду, которую выполнил Zinnector®, поэтому вы можете запустить её самостоятельно и просмотреть полный вывод. Обычно причиной являются проблемы с сетью или прокси-сервером (среда выполнения загружается с помощью вашего собственного npm, поэтому применяются настройки npm config set proxy … и зеркала реестра) либо незавершённая предыдущая установка, которая очищается с помощью параметра --reset-runtime.

Ошибка «the local playground exited before it was ready» или отсутствие готовности к работе

Запустите команду zinnector dev --verbose, чтобы просмотреть вывод самой среды выполнения. Самая частая причина — порт уже занят: используйте zinnector dev --port 9401 или задайте параметр port в файле zinnector.json. Если среда выполнения установилась, но не загружается: zinnector dev --reset-runtime. При первом запуске также загружается сам WordPress, поэтому при медленном соединении подождите несколько минут; интерфейс командной строки ожидает до пяти минут, прежде чем сообщить о тайм-ауте, вместо того чтобы зависать.

Ошибка «this project is not a git repository» при попытке отправки (push)

Развёртывание выполняется из репозитория, поэтому для zinnector push требуется репозиторий с удаленным репозиторием (remote), к которому у платформы есть доступ. Выполните git init && git add -A && git commit -m initial, добавьте удаленный репозиторий GitHub или GitLab, а затем выполните zinnector link для привязки к сайту.

После развёртывания сайт отображается как белый экран

Выполните команду zinnector check. В девяти случаях из десяти проблема заключается в несоответствии версий PHP (выполнялась сборка для более новой версии PHP, чем та, которая используется в слоте), и в отчёте будет указано, на какую версию следует переключить слот с помощью команды zinnector php <version> либо для какой версии следует выполнять разработку с помощью zinnector dev --php <version>. Сама критическая ошибка отображается в журнале zinnector logs --error.

См. также

• Начало работы · Локальная разработка · Развёртывание · Справочник команд