Грешке на које корисници заиста наилазе при коришћењу 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, па му на спорој вези дајте неколико минута; CLI чека до пет минута пре него што пријави истек времена уместо да се замрзне.
„this project is not a git repository“ при слању (push)
Дистрибуције се воде из ризнице, па је за zinnector push потребна ризница са удаљеним сервером коме платформа може да приступи. Покрените 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 приказује саму фаталну грешку.
Повезано