Отстраняване на неизправности в Zinnector®

Реалните грешки, които потребителите срещат с 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 файл без обвивка (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 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 … и огледален сървър (registry mirror) – или наполовина завършена предишна инсталация, която --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 изчаква до пет, преди да докладва изтичане на времето (timeout), вместо да забива.

"this project is not a git repository" при избутване (push)

Внедряванията се управляват от хранилище (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 показва самата фатална грешка.

Свързани

• Първи стъпки · Локална разработка · Внедряване · Справка за команди