Base de conhecimento
Solução de problemas do Zinnector®
Os erros que as pessoas realmente encontram com a CLI do Zinnector e a solução para cada um: spawn EINVAL no Windows, aviso EBADENGINE do npm, node-gyp pedindo o Visual Studio no Node 26, EPERM durante a instalação, um runtime que não inicia e uma porta em uso.
Os erros que as pessoas realmente encontram com o CLI do Zinnector®, o significado de cada um e a correção. Cada entrada traz o texto exato que você verá, para que você possa pesquisar nesta página por ele. Se o seu não estiver aqui, execute o comando com falha usando ZINNECTOR_DEBUG=1 e abra um problema em github.com/Zinn-Digital/zinnector/issues com a saída, o seu node --version e o seu sistema operacional.
"spawn EINVAL" logo após aceitar a instalação do ambiente de execução (Windows)
Um bug no Zinnector® 0.1.0 e 0.1.1. No Windows, o instalador do ambiente de execução executava npm.cmd pelo nome, e o Node recusou-se a iniciar um arquivo .cmd sem um shell desde a correção para o CVE-2024-27980 — portanto, a instalação falhou um segundo após você responder Y. Corrigido na versão 0.1.2: o npm agora é executado como node npm-cli.js, que é o mesmo em todas as plataformas e não precisa de shell. Execute npm install -g zinnector@latest e, em seguida, zinnector dev novamente.
"npm WARN EBADENGINE" durante a instalação, ou "Zinnector® needs Node 24 or newer"
A sua versão do Node é anterior à 24. O npm exibe o aviso porque o pacote declara engines: >=24.18.1; a instalação é concluída mesmo assim, mas o zinnector recusa-se a iniciar (código de saída 78) em vez de falhar em algum ponto confuso mais tarde. Instale a versão LTS atual em nodejs.org — winget install OpenJS.NodeJS.LTS no Windows, brew install node@24 no macOS —, confirme se node --version exibe v24 ou superior e instale o Zinnector® novamente.
"gyp ERR!", "Building from source with node-gyp" ou "You need to install Visual Studio"
O ambiente de execução do WordPress possui um módulo nativo cujos binários pré-compilados existem apenas para o Node 24 e 25. Em uma versão mais recente do Node (26 e superior, a partir de setembro de 2026), o instalador recorre à compilação a partir do código-fonte, o que em uma máquina Windows padrão resulta em uma solicitação do Visual Studio. Corrigido na versão 0.1.2: O Zinnector® detecta isso antes de baixar qualquer coisa e busca um Node 24 exclusivamente para o ambiente de execução — cerca de 30 MB, verificado com os checksums do nodejs.org —, de modo que nada é compilado. Se você ainda vir o erro após a atualização, execute zinnector dev --reset-runtime para que a instalação incompleta anterior seja descartada primeiro.
Avisos "EPERM" do npm durante a limpeza (Windows)
Quase sempre é um software antivírus ou um indexador de pesquisa mantendo um arquivo aberto em node_modules do ambiente de execução enquanto o npm tenta removê-lo. A instalação é tentada novamente a partir de um diretório limpo no próximo zinnector dev; se o problema persistir, zinnector dev --reset-runtime remove todo o diretório do ambiente de execução primeiro e instala novamente.
"the local playground runtime could not be installed"
A mensagem inclui as últimas linhas do próprio npm e o comando exato que o Zinnector® executou, para que você possa executá-lo por conta própria e ver a saída completa. As causas habituais são um problema de rede ou de proxy — o ambiente de execução é obtido com o seu próprio npm, portanto, npm config set proxy … e um espelho de registro se aplicam —, ou uma instalação anterior incompleta, que --reset-runtime limpa.
"the local playground exited before it was ready" ou o ambiente nunca fica pronto
Execute zinnector dev --verbose para ver a saída do próprio ambiente de execução. Uma porta já em uso é a causa comum: zinnector dev --port 9401, ou defina port em zinnector.json. Um ambiente de execução que foi instalado, mas não inicializa: zinnector dev --reset-runtime. A primeira inicialização também baixa o próprio WordPress; portanto, em uma conexão lenta, aguarde alguns minutos; a CLI aguarda até cinco minutos antes de relatar um tempo limite em vez de travar.
"this project is not a git repository" ao fazer push
As implantações são impulsionadas a partir de um repositório, portanto zinnector push precisa de um com um repositório remoto que a plataforma possa alcançar. git init && git add -A && git commit -m initial, adicione seu repositório remoto do GitHub ou GitLab e, em seguida, zinnector link para conectá-lo ao site.
O site fica em branco após uma implantação
Execute zinnector check. Em nove de cada dez casos, trata-se de uma lacuna na versão do PHP — você compilou em uma versão do PHP mais recente do que a executada pelo slot —, e o relatório indica para qual versão mudar o slot usando zinnector php <version>, ou para qual desenvolver usando zinnector dev --php <version>. zinnector logs --error mostra o erro fatal.
Relacionado
Ainda com problemas?
O suporte está incluído em todos os planos com respostas no seu próprio idioma.
Contatar o suporte → Todos os artigos →