A felhasználók által a Zinnector® CLI használata során ténylegesen tapasztalt hibák, azok jelentése és a javításuk módja. Minden bejegyzés pontosan azt a szöveget tartalmazza, amelyet látni fog, így rá tud keresni ezen az oldalon. Ha az Ön hibája nem szerepel itt, futtassa a sikertelen parancsot a ZINNECTOR_DEBUG=1 környezeti változóval, és nyisson egy hibajegyet a github.com/Zinn-Digital/zinnector/issues címen a kimenettel, a node --version verziószámával és az operációs rendszerének megjelölésével.
"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 0.1.1 verziójában. Windows rendszeren a futtatókörnyezet telepítője név szerint futtatta az npm.cmd parancsot, a Node pedig a CVE-2024-27980 javítása óta megtagadja a .cmd fájlok burok (shell) nélküli futtatását – így a telepítés egy másodperccel azután összeomlott, hogy Ön Y választ adott. Javítva a 0.1.2 verzióban: az npm mostantól node npm-cli.js formában fut, amely minden platformon azonos, és nem igényel burkot (shell). Futtassa az npm install -g zinnector@latest parancsot, majd ismét a zinnector dev parancsot.
"npm WARN EBADENGINE" a telepítés során, vagy "Zinnector® needs Node 24 or newer"
Az Ön Node verziója régebbi a 24-esnél. Az npm azért jeleníti meg a figyelmeztetést, mert a csomag a következő deklarációt tartalmazza: engines: >=24.18.1; a telepítés ennek ellenére befejeződik, de a zinnector ezt követően megtagadja az indulást (78-as hibakód), ahelyett, hogy később egy nehezen értelmezhető hibával állna le. Telepítse az aktuális LTS-verziót a nodejs.org oldalról – Windows rendszeren a winget install OpenJS.NodeJS.LTS, macOS rendszeren a brew install node@24 paranccsal –, ellenőrizze, hogy a node --version kimenete v24 vagy újabb, majd 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árisai kizárólag a Node 24 és 25 verziókhoz érhetők el. Újabb Node verzió esetén (26-os és újabb, 2026 szeptemberétől) a telepítője forrásból történő fordításra áll vissza, ami egy alapértelmezett Windows-gépen a Visual Studio telepítésének kérésével végződik. Javítva a 0.1.2 verzióban: a Zinnector® még a letöltés előtt észleli ezt, és kizárólag a futtatókörnyezet számára letölt egy Node 24-et – körülbelül 30 MB méretben, ellenőrizve a nodejs.org ellenőrzőösszegei alapján –, így semmi sem kerül forrásból lefordításra. Ha a frissítés után is ezt látja, futtassa a zinnector dev --reset-runtime parancsot, hogy a rendszer először elvethesse a korábbi, félig befejezett telepítést.
"EPERM" figyelmeztetések az npm részéről a takarítás során (Windows)
Szinte mindig egy víruskereső vagy egy 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és a következő zinnector dev futtatásakor egy tiszta könyvtárból újra megkísérlésre kerül; ha a hiba továbbra is fennáll, a zinnector dev --reset-runtime először eltávolítja a teljes futtatókörnyezeti könyvtárat, majd újra elvégzi a telepítést.
"the local playground runtime could not be installed"
Az üzenet tartalmazza az npm saját utolsó sorait és azt a pontos parancsot, amelyet a Zinnector® futtatott, így Ön saját maga is futtathatja, és láthatja a teljes kimenetet. A gyakori okok közé tartozik a hálózati vagy proxyprobléma – a futtatókörnyezet letöltése az Ön saját npm-ével történik, így az npm config set proxy … beállítás és a csomagtár-tükrözések érvényesek –, vagy egy félig befejezett korábbi telepítés, amelyet a --reset-runtime töröl.
"the local playground exited before it was ready", vagy soha nem áll készen
Futtassa a zinnector dev --verbose parancsot a futtatókörnyezet saját kimenetének megtekintéséhez. A leggyakoribb ok egy már használatban lévő port: használja a zinnector dev --port 9401 parancsot, vagy állítsa be a port értékét a zinnector.json fájlban. Egy olyan futtatókörnyezet esetén, amely települt, de nem indul el: zinnector dev --reset-runtime. Az első indítás magát a WordPress rendszert is letölti, így lassú kapcsolat esetén adjon neki néhány percet; a CLI akár öt percet is vár, mielőtt időtúllépést jelezne a lefagyás helyett.
"this project is not a git repository" a push művelet során
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, amely rendelkezik a platform által elérhető távoli (remote) kiszolgálóval. Futtassa a git init && git add -A && git commit -m initial parancsot, adja hozzá GitHub vagy GitLab távoli kiszolgálóját, majd a zinnector link segítségével kapcsolja össze a webhellyel.
A webhely fehér képernyőt mutat a közzététel (deploy) után
Futtassa a zinnector check parancsot. Tízből kilenc esetben a PHP-verziók eltérése áll a háttérben – Ön újabb PHP-n végezte a fejlesztést, mint amin a tárhelyfutási környezet (slot) fut –, a jelentés pedig megadja, hogy a zinnector php <version> paranccsal melyik verzióra kell átváltani a környezetet, vagy a zinnector dev --php <version> paranccsal melyikhez kell fejleszteni. A zinnector logs --error parancs magát a végzetes hibát (fatal error) jeleníti meg.
Kapcsolódó anyagok