Baza de cunoștințe
Depanare Zinnector®
Erorile pe care le întâmpină efectiv oamenii cu utilitarul CLI Zinnector și remedierea pentru fiecare: spawn EINVAL pe Windows, avertismentul EBADENGINE de la npm, node-gyp care cere Visual Studio pe Node 26, EPERM în timpul instalării, un mediu de execuție care nu pornește și un port utilizat.
Erorile pe care utilizatorii le întâlnesc efectiv cu CLI-ul Zinnector®, semnificația fiecăreia și soluția. Fiecare intrare menționează textul exact pe care îl veți vedea, astfel încât să puteți căuta pe această pagină. Dacă a dumneavoastră nu se află aici, rulați comanda care a eșuat cu ZINNECTOR_DEBUG=1 și deschideți o problemă la github.com/Zinn-Digital/zinnector/issues împreună cu rezultatul generat, node --version și sistemul dumneavoastră de operare.
„spawn EINVAL” imediat după acceptarea instalării mediu de rulare (Windows)
O eroare în Zinnector® 0.1.0 și 0.1.1. Pe Windows, programul de instalare a mediu de rulare a rulat npm.cmd după nume, iar Node a refuzat să lanseze un fișier .cmd fără un shell de la remedierea sa pentru CVE-2024-27980 — astfel încât instalarea s-a blocat la o secundă după ce ați răspuns cu Y. Remediat în 0.1.2: npm este rulat acum ca node npm-cli.js, ceea ce este identic pe orice platformă și nu necesită niciun shell. Rulați npm install -g zinnector@latest, apoi din nou zinnector dev.
„npm WARN EBADENGINE” în timpul instalării sau „Zinnector® needs Node 24 or newer”
Versiunea dumneavoastră de Node este mai veche decât 24. npm afișează avertismentul deoarece pachetul declară engines: >=24.18.1; instalarea se finalizează oricum, dar zinnector refuză apoi să pornească (cod de ieșire 78) în loc să eșueze undeva confuz mai târziu. Instalați versiunea LTS actuală de la nodejs.org — winget install OpenJS.NodeJS.LTS pe Windows, brew install node@24 pe macOS — confirmați că node --version afișează v24 sau o versiune superioară și instalați din nou Zinnector®.
„gyp ERR!”, „Building from source with node-gyp” sau „You need to install Visual Studio”
Mediul de rulare WordPress are un modul nativ ale cărui binare precompilate există doar pentru Node 24 și 25. Pe o versiune mai nouă de Node (26 și ulterioare, începând cu septembrie 2026), programul de instalare revine la compilarea din sursă, ceea ce pe un computer Windows obișnuit se soldează cu o solicitare pentru Visual Studio. Remediat în 0.1.2: Zinnector® detectează acest lucru înainte de a descărca ceva și preia un Node 24 exclusiv pentru mediul de rulare — de aproximativ 30 MB, verificat cu sumele de control de pe nodejs.org — astfel încât nimic nu este compilat vreodată. Dacă îl vedeți în continuare după actualizare, rulați zinnector dev --reset-runtime pentru ca instalarea incompletă dinainte să fie eliminată mai întâi.
Avertismente „EPERM” de la npm în timpul curățării (Windows)
Aproape întotdeauna un scaner antivirus sau un indexator de căutare care ține un fișier deschis în directorul node_modules al mediului de rulare în timp ce npm încearcă să îl elimine. Instalarea este reîncercată dintr-un director curat la următorul zinnector dev; dacă persistă, zinnector dev --reset-runtime elimină mai întâi întregul director al mediului de rulare și instalează din nou.
„the local playground runtime could not be installed”
Mesajul include ultimele rânduri proprii ale npm și comanda exactă pe care a rulat-o Zinnector®, astfel încât să o puteți rula singur și să vedeți rezultatul complet. Cauzele obișnuite sunt o problemă de rețea sau de proxy — mediul de rulare este preluat cu propriul dumneavoastră npm, deci se aplică npm config set proxy … și o oglindă de registry — sau o instalare anterioară incompletă, pe care --reset-runtime o șterge.
„the local playground exited before it was ready” sau nu devine niciodată pregătit
Rulați zinnector dev --verbose pentru a vedea propriul rezultat al mediului de rulare. Un port deja utilizat este o cauză comună: zinnector dev --port 9401 sau setați port în zinnector.json. Un mediu de rulare care s-a instalat, dar nu pornește: zinnector dev --reset-runtime. Prima pornire descarcă, de asemenea, WordPress în sine, așa că pe o conexiune lentă acordați-i câteva minute; CLI-ul așteaptă până la cinci înainte de a raporta o expirare a timpului de așteptare, în loc să se blocheze.
„this project is not a git repository” la trimitere (push)
Implementările sunt lansate dintr-un repository, așa că zinnector push are nevoie de unul cu un remote pe care platforma îl poate accesa. git init && git add -A && git commit -m initial, adăugați remote-ul dumneavoastră GitHub sau GitLab, apoi zinnector link pentru a-l conecta la site.
Site-ul este alb după o implementare
Rulați zinnector check. Nouă cazuri din zece reprezintă o discrepanță de versiune PHP — ați compilat pe o versiune de PHP mai nouă decât cea pe care rulează slotul — iar raportul indică la ce versiune să comutați slotul cu zinnector php <version> sau pe baza căreia să dezvoltați cu zinnector dev --php <version>. zinnector logs --error afișează eroarea fatală propriu-zisă.
Relaționate
Încă blochezi?
Asistența este inclusă în orice plan și oferă răspunsuri în limba ta.
Contactați asistența tehnică → Toate articolele →