Base ng Kaalaman
Pag-troubleshoot ng Zinnector®
Ang mga error na aktuwal na nararanasan ng mga tao gamit ang Zinnector CLI at ang solusyon para sa bawat isa: spawn EINVAL sa Windows, babala ng EBADENGINE ng npm, node-gyp na humihingi ng Visual Studio sa Node 26, EPERM sa panahon ng pag-install, isang runtime na hindi mag-boot, and a port in use.
Ang mga error na aktuwal na nararanasan ng mga tao gamit ang Zinnector® CLI, kung ano ang ibig sabihin ng bawat isa, at ang solusyon. Ipinapangalan ng bawat entry ang eksaktong text na makikita mo, para ma-search mo ito sa pahinang ito. Kung wala rito ang sa iyo, patakbuhin ang command na nagka-error gamit ang ZINNECTOR_DEBUG=1 at magbukas ng issue sa github.com/Zinn-Digital/zinnector/issues kasama ang output, ang iyong node --version, at ang iyong operating system.
"spawn EINVAL" pagkatapos na pagkatapos tanggapin ang pag-install ng runtime (Windows)
Isang bug sa Zinnector® 0.1.0 at 0.1.1. Sa Windows, pinatakbo ng installer ng runtime ang npm.cmd ayon sa pangalan, at tumanggi ang Node na mag-spawn ng .cmd file nang walang shell mula noong pag-aayos nito para sa CVE-2024-27980 — kaya nag-crash ang pag-install isang segundo pagkatapos mong sagutin ng Y. Naayos sa 0.1.2: pinatatakbo na ngayon ang npm bilang node npm-cli.js, na pareho sa bawat platform at hindi nangangailangan ng shell. Patakbuhin ang npm install -g zinnector@latest, pagkatapos ay ang zinnector dev muli.
"npm WARN EBADENGINE" sa panahon ng pag-install, o "Zinnector® needs Node 24 or newer"
Mas luma sa 24 ang iyong Node. Naglilimbag ang npm ng babala dahil idineklara ng package ang engines: >=24.18.1; natatapos pa rin ang pag-install, ngunit tumatanggi namang magsimula ang zinnector (exit code 78) sa halip na mabigo sa isang nakakalitong bahagi mamaya. I-install ang kasalukuyang LTS mula sa nodejs.org — winget install OpenJS.NodeJS.LTS sa Windows, brew install node@24 sa macOS — kumpirmahing naglilimbag ang node --version ng v24 o mas mataas, at i-install muli ang Zinnector®.
"gyp ERR!", "Building from source with node-gyp", o "You need to install Visual Studio"
Ang WordPress runtime ay may katutubong module na ang mga prebuilt binary ay umiiral para sa Node 24 at 25 lamang. Sa mas bagong Node (26 pataas, simula noong Setyembre 2026) ang installer nito ay bumabalik sa pag-compile mula sa source, na sa isang karaniwang makinang Windows ay nagtatapos sa isang kahilingan para sa Visual Studio. Naayos sa 0.1.2: nakikita ito ng Zinnector® bago mag-download ng anuman at kumukuha ng Node 24 para sa runtime lamang — humigit-kumulang 30 MB, na na-verify laban sa mga checksum ng nodejs.org — kaya walang kailanman na-compile. Kung nakikita mo pa rin ito pagkatapos mag-upgrade, patakbuhin ang zinnector dev --reset-runtime upang itapon muna ang kalahating tapos na pag-install mula noong una.
Mga babalang "EPERM" mula sa npm habang naglilinis ito (Windows)
Halos palaging isang antivirus scanner o isang search indexer ang nag-aabang sa isang file na bukas sa ilalim ng node_modules ng runtime habang sinusubukang alisin ito ng npm. Sinusubukang muli ang pag-install mula sa isang malinis na direktoryo sa susunod na zinnector dev; kung patuloy itong nangyayari, inaalis ng zinnector dev --reset-runtime ang buong direktoryo ng runtime muli at nag-iinstall.
"the local playground runtime could not be installed"
Kasama sa mensahe ang sariling huling mga linya ng npm at ang eksaktong command na pinatakbo ng Zinnector®, para maipatakbo mo ito sa iyong sarili at makita ang buong output. Ang mga karaniwang sanhi ay problema sa network o proxy — ang runtime ay kinukuha gamit ang iyong sariling npm, kaya nalalapat ang npm config set proxy … at isang registry mirror — o isang kalahating tapos na mas maagang pag-install, na nililinis ng --reset-runtime.
"the local playground exited before it was ready", o hindi ito kailanman naging handa
Patakbuhin ang zinnector dev --verbose upang makita ang sariling output ng runtime. Ang isang port na ginagamit na ay ang karaniwan: zinnector dev --port 9401, o itakda ang port sa zinnector.json. Isang runtime na na-install ngunit hindi mag-boot: zinnector dev --reset-runtime. Dina-download din ng unang pag-boot ang WordPress mismo, kaya sa isang mabagal na koneksyon ay bigyan ito ng ilang minuto; naghihintay ang CLI ng hanggang lima bago mag-ulat ng timeout sa halip na mag-hang.
"this project is not a git repository" sa pag-push
Ang mga pag-deploy ay hinimok mula sa isang repository, kaya ang zinnector push ay nangangailangan ng isa na may remote na maaabot ng platform. git init && git add -A && git commit -m initial, idagdag ang iyong remote sa GitHub o GitLab, pagkatapos ay zinnector link upang ikonekta ito sa site.
Puti ang site pagkatapos ng isang pag-deploy
Patakbuhin ang zinnector check. Siyam na beses sa sampu ito ay isang puwang sa bersyon ng PHP — nagtayo ka sa isang mas bagong PHP kaysa sa pinatatakbo ng slot — at sinasabi ng ulat kung aling bersyon ang lilipatan ng slot gamit ang zinnector php <version>, o kung alin ang ide-develop laban sa gamit ang zinnector dev --php <version>. Ipinapakita ng zinnector logs --error ang fatal mismo.
Kaugnay
Na-stuck pa rin?
Kasama ang suporta sa bawat plano at may mga sagot sa iyong sariling wika.
Makipag-ugnayan sa suporta → Lahat ng artikulo →