Грешките, с които потребителите действително се сблъскват при Zinnector® CLI, какво означава всяка от тях и как се отстранява. Всеки запис посочва точния текст, който ще видите, така че можете да търсите на тази страница по него. Ако Вашият случай липсва тук, изпълнете неуспешната команда със 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 MB, проверени спрямо контролните суми на 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“ при качване
Внедряванията се управляват от хранилище, затова 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 показва самата фатална грешка.
Свързани теми