Rozwiązywanie problemów z Zinnector®

Błędy, na które użytkownicy rzeczywiście trafiają podczas korzystania z interfejsu wiersza poleceń Zinnector®, co oznacza każdy z nich oraz sposób ich naprawy. Każda pozycja podaje dokładny tekst, jaki zobaczysz, dzięki czemu możesz wyszukać go na tej stronie. Jeśli Twojego błędu tu nie ma, uruchom polecenie, które zakończyło się niepowodzeniem, z parametrem ZINNECTOR_DEBUG=1 i utwórz zgłoszenie w witrynie github.com/Zinn-Digital/zinnector/issues wraz z wyjściem polecenia, wersją zwróconą przez node --version oraz swoim systemem operacyjnym.

"spawn EINVAL" tuż po zaakceptowaniu instalacji środowiska uruchomieniowego (Windows)

Błąd w wersjach Zinnector® 0.1.0 i 0.1.1. W systemie Windows instalator środowiska uruchomieniowego wywoływał npm.cmd po nazwie, a platforma Node od czasu poprawki CVE-2024-27980 odmawia uruchomienia pliku .cmd bez powłoki (shell) – w rezultacie instalacja uległa awarii sekundę po udzieleniu odpowiedzi Y. Naprawiono w wersji 0.1.2: program npm jest now uruchamiany jako node npm-cli.js, co wygląda tak samo na każdej platformie i nie wymaga powłoki. Uruchom npm install -g zinnector@latest, a następnie ponownie zinnector dev.

"npm WARN EBADENGINE" podczas instalacji lub "Zinnector® needs Node 24 or newer"

Twoja wersja Node jest starsza niż 24. Narzędzie npm wyświetla to ostrzeżenie, ponieważ pakiet deklaruje engines: >=24.18.1; instalacja kończy się mimo to, ale zinnector odmawia wówczas uruchomienia (kod wyjścia 78), zamiast kończyć się niepowodzeniem w jakimś niejasnym miejscu później. Zainstaluj bieżącą wersję LTS z witryny nodejs.org – za pomocą polecenia winget install OpenJS.NodeJS.LTS w systemie Windows lub brew install node@24 w systemie macOS – upewnij się, że polecenie node --version wypisuje v24 lub nowszą wersję, a następnie zainstaluj Zinnector® ponownie.

"gyp ERR!", "Building from source with node-gyp" lub "You need to install Visual Studio"

Środowisko uruchomieniowe WordPress zawiera moduł natywny, którego wstępnie skompilowane pliki binarne istnieją tylko dla systemów Node 24 i 25. W nowszej wersji Node (26 i nowszych, stan na wrzesień 2026 r.) instalator powraca do kompilacji ze źródła, co na czystym komputerzie z systemem Windows kończy się żądaniem zainstalowania programu Visual Studio. Naprawiono w wersji 0.1.2: Zinnector® wykrywa to przed pobraniem czegokolwiek i pobiera środowisko Node w wersji 24 przeznaczone wyłącznie dla środowiska uruchomieniowego – około 30 MB, zweryfikowane za pomocą sum kontrolnych witryny nodejs.org – dzięki czemu nic nie jest kompilowane. Jeśli po uaktualnieniu nadal widzisz ten komunikat, uruchom zinnector dev --reset-runtime, aby najpierw odrzucić niedokończoną instalację z przeszłości.

Ostrzeżenia "EPERM" zgłaszane przez npm podczas czyszczenia (Windows)

Prawie zawsze jest to wynik blokowania pliku w katalogu node_modules środowiska uruchomieniowego przez program antywirusowy lub indeksator wyszukiwania w trakcie próby usunięcia go przez npm. Instalacja zostanie ponowiona z czystego katalogu podczas kolejnego wywołania polecenia zinnector dev; jeśli problem będzie się powtarzał, polecenie zinnector dev --reset-runtime najpierw usunie cały katalog środowiska uruchomieniowego, a następnie zainstaluje je ponownie.

"the local playground runtime could not be installed"

Komunikat zawiera ostatnie linie zwrócone przez samo npm oraz dokładne polecenie, które wykonał Zinnector®, dzięki czemu możesz uruchomić je samodzielnie i zobaczyć pełny wynik. Zazwyczaj przyczyną jest problem z siecią lub serwerem proxy – środowisko uruchomieniowe jest pobierane za pomocą Twojego własnego npm, więc zastosowanie mają ustawienia npm config set proxy … oraz serwer lustrzany rejestru (registry mirror) – lub niedokończona wcześniejsza instalacja, którą usuwa opcja --reset-runtime.

"the local playground exited before it was ready" lub środowisko nie staje się gotowe

Uruchom zinnector dev --verbose, aby zobaczyć wynik działania samego środowiska uruchomieniowego. Częstą przyczyną jest port zajęty przez inny proces: użyj zinnector dev --port 9401 lub skonfiguruj port w pliku zinnector.json. W przypadku środowiska, które zostało zainstalowane, ale nie chce się uruchomić: zinnector dev --reset-runtime. Pierwsze uruchomienie pobiera również samego WordPressa, więc przy powolnym połączeniu daj mu kilka minut; interfejs wiersza poleceń czeka do pięciu minut przed zgłoszeniem przekroczenia limitu czasu zamiast zawieszać się.

"this project is not a git repository" podczas publikowania (push)

Wdrożenia są sterowane z poziomu repozytorium, więc polecenie zinnector push wymaga repozytorium z pilotem (remote), do którego platforma ma dostęp. Wykonaj git init && git add -A && git commit -m initial, dodaj pilota GitHub lub GitLab, a następnie połącz go z witryną za pomocą zinnector link.

Strona jest biała po wdrożeniu

Uruchom zinnector check. W dziewięciu przypadkach na dziesięć jest to rozbieżność wersji PHP – kompilacja nastąpiła w nowszej wersji PHP niż ta, na której działa slot – a raport wskazuje, na jaką wersję przełączyć slot za pomocą zinnector php <version> lub pod jaką wersją prowadzić prace rozwojowe za pomocą zinnector dev --php <version>. Polecenie zinnector logs --error wyświetla sam błąd krytyczny.

Powiązane

• Pierwsze kroki · Rozwój lokalny · Wdrażanie · Dokumentacja poleceń