База знань
Усунення несправностей Zinnector®
Помилки, з якими користувачі реально стикаються у CLI Zinnector, та способи їх усунення: spawn EINVAL у Windows, попередження EBADENGINE від npm, запит node-gyp на встановлення Visual Studio у Node 26, EPERM під час встановлення, середовище виконання, що не завантажується, і зайнятий порт.
Помилки, з якими користувачі реально стикаються у 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 відмовляється запускати файл .cmd без оболонки після виправлення 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, тому за повільного з'єднання зачекайте кілька хвилин; 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 показує саму фатальну помилку.
Пов'язані теми
Все ще потрібна допомога?
Підтримка включена до кожного тарифного плану та надається рідною мовою.
Звернутися до підтримки → Усі статті →