Wissensdatenbank
Zinnector®-Fehlerbehebung
Die Fehler, auf die Nutzer mit dem Zinnector CLI tatsächlich stoßen, und die jeweilige Lösung: spawn EINVAL unter Windows, die EBADENGINE-Warnung von npm, node-gyp verlangt Visual Studio unter Node 26, EPERM während der Installation, eine Runtime, die nicht startet, und ein belegter Port.
Die Fehler, die bei der Verwendung der Zinnector® CLI tatsächlich auftreten, was sie bedeuten und wie Sie sie beheben können. Jeder Eintrag nennt den genauen Text, der angezeigt wird, sodass Sie diese Seite danach durchsuchen können. Wenn Ihr Fehler nicht dabei ist, führen Sie den fehlgeschlagenen Befehl mit ZINNECTOR_DEBUG=1 aus und öffnen Sie ein Problem unter github.com/Zinn-Digital/zinnector/issues mit der Ausgabe, Ihrer node --version und Ihrem Betriebssystem.
„spawn EINVAL“ direkt nach dem Akzeptieren der Laufzeitinstallation (Windows)
Ein Fehler in Zinnector® 0.1.0 und 0.1.1. Unter Windows führte das Installationsprogramm für die Laufzeitumgebung npm.cmd namentlich aus, und Node weigert sich seit der Behebung von CVE-2024-27980, eine .cmd-Datei ohne Shell zu starten – daher stürzte die Installation eine Sekunde nach Ihrer Antwort mit Y ab. Behoben in 0.1.2: npm wird nun als node npm-cli.js ausgeführt, was auf jeder Plattform gleich ist und keine Shell benötigt. Führen Sie npm install -g zinnector@latest und danach erneut zinnector dev aus.
„npm WARN EBADENGINE“ während der Installation oder „Zinnector® needs Node 24 or newer“
Ihre Node-Version ist älter als 24. npm gibt diese Warnung aus, da das Paket engines: >=24.18.1 deklariert; die Installation wird zwar abgeschlossen, aber zinnector verweigert anschließend den Start (Exit-Code 78), anstatt später an einer unklaren Stelle fehlschlagen. Installieren Sie das aktuelle LTS von nodejs.org – winget install OpenJS.NodeJS.LTS unter Windows, brew install node@24 unter macOS –, vergewissern Sie sich, dass node --version v24 oder höher ausgibt, und installieren Sie Zinnector® erneut.
„gyp ERR!“, „Building from source with node-gyp“ oder „You need to install Visual Studio“
Die WordPress-Laufzeitumgebung verfügt über ein natives Modul, dessen vorgefertigte Binärdateien nur für Node 24 und 25 existieren. Bei einer neueren Node-Version (26 und höher, Stand September 2026) greift das Installationsprogramm auf die Kompilierung aus dem Quellcode zurück, was auf einem standardmäßigen Windows-Computer zu einer Aufforderung zur Installation von Visual Studio führt. Behoben in 0.1.2: Zinnector® erkennt dies vor dem Herunterladen und ruft ein Node 24 ausschließlich für die Laufzeitumgebung ab – etwa 30 MB, überprüft anhand der Prüfsummen von nodejs.org –, sodass niemals etwas kompiliert wird. Wenn das Problem nach dem Aktualisieren weiterhin auftritt, führen Sie zinnector dev --reset-runtime aus, damit die halbfertige Installation von zuvor zuerst verworfen wird.
„EPERM“-Warnungen von npm während der Bereinigung (Windows)
Fast immer handelt es sich dabei um einen Antivirenscanner oder Suchindex, der eine Datei im Verzeichnis node_modules der Laufzeitumgebung gesperrt hält, während npm versucht, sie zu entfernen. Die Installation wird beim nächsten zinnector dev in einem sauberen Verzeichnis wiederholt; falls das Problem weiterhin besteht, entfernt zinnector dev --reset-runtime zunächst das gesamte Laufzeitverzeichnis und installiert es erneut.
„the local playground runtime could not be installed“
Die Meldung enthält die letzten Zeilen von npm selbst und den genauen Befehl, den Zinnector® ausgeführt hat, sodass Sie ihn selbst ausführen und die vollständige Ausgabe einsehen können. Die üblichen Ursachen sind Netzwerk- oder Proxy-Probleme – die Laufzeitumgebung wird über Ihr eigenes npm abgerufen, weshalb npm config set proxy … und ein Registry-Mirror greifen –, oder eine halbfertige vorherige Installation, die durch --reset-runtime bereinigt wird.
„the local playground exited before it was ready“ oder es wird nie betriebsbereit
Führen Sie zinnector dev --verbose aus, um die Ausgabe der Laufzeitumgebung anzuzeigen. Ein bereits belegter Port ist eine häufige Ursache: zinnector dev --port 9401 oder das Festlegen von port in zinnector.json. Eine Laufzeitumgebung, die zwar installiert wurde, aber nicht startet: zinnector dev --reset-runtime. Beim ersten Start wird außerdem WordPress selbst herunterladen; geben Sie der Anwendung bei einer langsamen Verbindung daher einige Minuten Zeit. Die CLI wartet bis zu fünf Minuten, bevor sie einen Timeout gemeldet, anstatt zu hängen.
„this project is not a git repository“ beim Push
Bereitstellungen werden über ein Repository gesteuert, weshalb zinnector push eines mit einem Remote-Repository benötigt, das die Plattform erreichen kann. git init && git add -A && git commit -m initial, fügen Sie Ihr GitHub- oder GitLab-Remote-Repository hinzu und führen Sie dann zinnector link aus, um es mit der Website zu verbinden.
Die Website ist nach einer Bereitstellung weiß
Führen Sie zinnector check aus. In neun von zehn Fällen liegt eine Diskrepanz bei der PHP-Version vor – Sie haben mit einer neueren PHP-Version erstellt, als der Slot verwendet –, und der Bericht gibt an, zu welcher Version mit zinnector php <version> gewechselt werden soll oder gegen welche mit zinnector dev --php <version> entwickelt werden soll. zinnector logs --error zeigt den eigentlichen schwerwiegenden Fehler an.
Verwandt
Immer noch nicht weiter?
Der Support ist in jedem Tarif enthalten und antwortet in Ihrer eigenen Sprache.
Support kontaktieren → Alle Artikel →