Solução de Problemas

Se você tiver algum problema com seu site estático, confira a seguir dicas e soluções para erros comuns.

Erro 403

Se a implantação do seu site for concluída sem erros, mas você ver um erro 403 ao tentar visitar o site no seu navegador, aqui estão algumas coisas para verificar:

1. Se o seu site depende de uma etapa de build, o Comando build (Configurações > Detalhes básicos) está preenchido e correto?
2. O Diretório de publicação está correto?
3. As permissões de arquivo* estão corretas? Em geral, recomendamos as seguintes permissões para sites estáticos:
   • Diretórios: 755
   • Arquivos: 644

*As permissões de arquivo controlam quem pode:

• Ler: ver o conteúdo de um arquivo ou visualizar arquivos em um diretório.
• Escrever: Modificar um arquivo ou adicionar, ou excluir arquivos em um diretório.
• Executar: Executar um arquivo e/ou executá-lo como um script, ou acessar um diretório e executar funções e comandos.

Cada arquivo e diretório tem seu próprio conjunto de permissões de arquivo, mostrado como um número de três dígitos. Cada número indica o nível de permissão para cada categoria (leitura, gravação e execução) mostrada acima.

Erro 404

Se a implantação do seu site for concluída sem erros, mas você ver um erro 404 ao tentar visitar o site no navegador, há algumas coisas a verificar:

1. Se o seu site depende de uma etapa de build, o Comando build (Configurações > Detalhes básicos) está preenchido e correto?
2. O Diretório de publicação está correto?
3. Seu repositório é compatível com a Hospedagem de Sites Estáticos? Ele deve conter:
   1. Uma framework de site estático que use o Node.js para a etapa de build.
   2. Ou arquivos estáticos, como HTML, CSS e Javascript, que não exigem uma etapa de build (deixe o Comando build em branco).

O Comando build informa ao nosso sistema como montar o seu site, e o Diretório de publicação é o subdiretório em que os arquivos do site finalizado residem, em relação à raiz do seu repositório. É fundamental que você preencha esses campos corretamente se o seu site depender de uma etapa de build. Isso garantirá que o site seja criado e servido como você pretende. Se o Comando build for deixado em branco, o sistema poderá indicar que a implantação está concluída, mas carregará apenas o conteúdo não compilado do seu repositório.

Versão incorreta do Node

Se você inserir um comando build para o seu site, poderá selecionar a versão do Node a ser usada. Se você selecionar a versão incorreta, a implantação falhará e haverá um erro no registro de build e implantação que indica que é necessária uma versão diferente do Node.js, semelhante a esta:

"Build project": error [email protected]: The engine "node" is incompatible with this module. Expected version "16.14.0". Got "16.20.0"

Verifique as configurações do seu site estático, altere a versão do Node conforme necessário e implemente manualmente o site novamente (clique em Implantar agora na página Implantações).

Não é possível determinar o gerenciador de pacotes

Se ocorrer um problema com o comando build ou com o arquivo de configuração, você poderá ver o seguinte erro:

Error: Unable to determine package manager

Esse erro geralmente ocorre devido a um comando build incorreto ou a um arquivo package.json ausente, ou configurado incorretamente. Aqui estão algumas coisas que você pode verificar:

1. 1. O Comando build (Configurações > Detalhes básicos) está preenchido e correto?
   2. O arquivo package.json está em seu repositório git?
   3. O arquivo package.json está configurado corretamente, incluindo qualquer versão conflitante do Node? Por exemplo, você pode ter escolhido a versão 18.16.0 do Node ao adicionar o site estático, mas no arquivo package.json, você pode ter definido a versão do Node para algo diferente, como no exemplo a seguir:
      Copy

      "engines": {
      "node": ">=20.0.0"
      },