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

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

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

Ошибка в Zinnector® 0.1.0 и 0.1.1. В Windows установщик среды выполнения вызывал npm.cmd по имени, а Node после исправления уязвимости CVE-2024-27980 отказывается запускать файлы .cmd без командной оболочки — в результате установка завершалась сбоем через секунду после того, как вы вводили 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, поэтому при медленном соединении подождите несколько минут; CLI ждет до пяти минут перед выводом сообщения о превышении времени ожидания, не зависая бесконечно.

«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 покажет саму фатальную ошибку.

См. также

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