Zinnector® hibaelhárítás

A hibák, amelyekkel a felhasználók valóban találkoznak a Zinnector CLI használatakor, és mindegyik javítása: spawn EINVAL Windows rendszeren, az npm EBADENGINE figyelmeztetése, a node-gyp Visual Studio-t kérő kérése Node 26 alatt, EPERM a telepítés során, egy futtatókörnyezet, amely nem indul el, és egy használatban lévő port.

A Zinnector® CLI-val a felhasználók által ténylegesen tapasztalt hibák, azok jelentése és a javításuk. Minden egyes bejegyzés pontosan tartalmazza a látni fog szöveget, így rákereshet erre az oldalra. Ha az Öné nem szerepel itt, futtassa a hibás parancsot a ZINNECTOR_DEBUG=1 környezeti változóval, és nyisson meg egy hibajegyet a github.com/Zinn-Digital/zinnector/issues címen a kimenettel, a node --version paranccsal és az operációs rendszerével együtt.

„spawn EINVAL” közvetlenül a futtatókörnyezet telepítésének elfogadása után (Windows)

Hiba a Zinnector® 0.1.0-s és 0.1.1-es verziójában. Windows rendszeren a futtatókörnyezet telepítője név szerint futtatta az npm.cmd fájlt, és a Node a CVE-2024-27980 javítása óta shell nélkül visszautasítja a .cmd fájlok indítását – így a telepítés egy másodperccel azután összeomlott, hogy az Y (Igen) válaszra lépett. A 0.1.2-es verzióban javítva: Az npm futtatása mostantól node npm-cli.js formában történik, ami minden platformon azonos, és nem igényel shellt. Futtassa az npm install -g zinnector@latest parancsot, majd ismét a zinnector dev parancsot.

„npm WARN EBADENGINE” figyelmeztetés telepítés közben, vagy „Zinnector® needs Node 24 or newer”

Az Ön Node verziója régebbi, mint 24. Az npm azért küldi a figyelmeztetést, mert a csomag az engines: >=24.18.1 értéket deklarálja; a telepítés ettől függetlenül befejeződik, de a zinnector ezután megtagadja az indulást (78-as kilépési kód), ahelyett, hogy később valamilyen zavaros helyenhiba lépne fel. Telepítse az aktuális LTS-verziót a nodejs.org webhelyről – Windows rendszeren a winget install OpenJS.NodeJS.LTS, macOS-en a brew install node@24 paranccsal –, ellenőrizze, hogy a node --version a v24-es vagy újabb verziót írja-e ki, és telepítse újra a Zinnector® eszközt.

„gyp ERR!”, „Building from source with node-gyp” vagy „You need to install Visual Studio”

A WordPress futtatókörnyezet rendelkezik egy natív modullal, amelynek előre lefordított bináris fájljai csak a Node 24 és 25 verziókhoz léteznek. Újabb Node verzión (26 és újabb, 2026 szeptembere óta) a telepítője visszalép a forrásból történő fordításra, ami egy sima Windows gépen a Visual Studio telepítésére vonatkozó kérésbe torkollik. A 0.1.2-es verzióban javítva: A Zinnector® ezt még bármilyen letöltés előtt felismeri, és kizárólag a futtatókörnyezet számára lekér egy Node 24 verziót – ez körülbelül 30 MB, ellenőrizve a nodejs.org ellenőrzőösszegeivel –, így semmit sem kell fordítani. Ha a frissítés után is ezt látja, futtassa a zinnector dev --reset-runtime parancsot, hogy a korábbi, félig elkészült telepítés először törlésre kerüljön.

„EPERM” figyelmeztetések az npm-től takarítás közben (Windows)

Szinte mindig víruskereső vagy keresési indexelő okozza, amely nyitva tart egy fájlt a futtatókörnyezet node_modules mappájában, miközben az npm megpróbálja eltávolítani azt. A telepítést a következő zinnector dev parancs tiszta könyvtárból újra megpróbálja; ha a hiba továbbra is fennáll, a zinnector dev --reset-runtime paranccsal először távolítsa el a teljes futtatókörnyezet-könyvtárat, majd telepítse újra.

„the local playground runtime could not be installed”

Az üzenet tartalmazza magának az npm-nek az utolsó sorait és a Zinnector® által futtatott pontos parancsot, így azt maga is lefuttathatja, és láthatja a teljes kimenetet. A szokásos okok hálózati vagy proxyproblémák – a futtatókörnyezetet a saját npm-je tölti le, így az npm config set proxy … és a registry tükör érvényesül –, vagy egy félig elkészült korábbi telepítés, amelyet a --reset-runtime töröl.

„the local playground exited before it was ready”, vagy soha nem válik készre

A futtatókörnyezet saját kimenetének megtekintéséhez futtassa a zinnector dev --verbose parancsot. A gyakori ok a már használatban lévő port: használja a zinnector dev --port 9401 parancsot, vagy állítsa be a port értéket a zinnector.json fájlban. Olyan futtatókörnyezet esetén, amely települt, de nem indul el: zinnector dev --reset-runtime. Az első indítás a WordPress-t magát is letölti, ezért lassú kapcsolat esetén szánjon rá néhány percet; a CLI legfeljebb öt percet vár, mielőtt időtúúllépést jelentene ahelyett, hogy nem reagálna.

„this project is not a git repository” pusholáskor

A telepítések egy tárolóból (repository) indulnak, így a zinnector push parancshoz szükség van egy olyan tárolóra, amelynek van a platform által elérhető távoli elérése (remote). git init && git add -A && git commit -m initial, adja hozzá a GitHub vagy GitLab távoli elérését, majd a zinnector link paranccsal csatlakoztassa a webhelyhez.

A webhely üres (fehér) a telepítés után

Futtassa a zinnector check parancsot. Tízből kilenc esetben PHP-verzióeltérésről van szó – újabb PHP-verzión építette, mint amin a foglalat (slot) fut –, és a jelentés megmondja, hogy melyik verzióra kell átváltani a slotot a zinnector php <version> paranccsal, vagy amihez fejlesztést kell végezni a zinnector dev --php <version> paranccsal. A zinnector logs --error parancs mutatja magát a végzetes (fatal) hibát.

Kapcsolódó

Kezdeti lépések · Helyi fejlesztés · Telepítés · Parancsreferencia