Solução de erros 404 para sites do GitHub Pages

Este guia ajudará você a solucionar problemas comuns que acarretam em um erro 404.

Quem pode usar esse recurso?

O GitHub Pages está disponível em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com o GitHub Pro, o GitHub Team, o GitHub Enterprise Cloud e o GitHub Enterprise Server.

O

Solução de erros 404

Neste guia, veja algumas causas comuns para a exibição de um erro 404 durante a criação de um site do GitHub Pages.

Página de status do GitHub

Se um erro 404 for exibido durante a criação de um site do GitHub Pages, verifique primeiro se a Página de status do GitHub contém algum incidente ativo.

Cache do navegador

Quando o site do GitHub Pages é privado e um erro 404 é exibido, pode ser necessário limpar o cache do navegador. Para obter mais informações sobre limpeza do cache, consulte a documentação do navegador.

Arquivo index.html

O GitHub Pages procurará um arquivo index.html como o arquivo de entrada para o site.

  • Tenha um arquivo index.html no repositório do site no GitHub Enterprise Server. Para saber mais, confira Criar um site do GitHub Pages.

  • O arquivo de entrada deve estar no nível superior da fonte de publicação escolhida. Por exemplo, se a fonte de publicação for o diretório /docs do branch main, o arquivo de entrada deverá estar no diretório /docs de um branch chamado main.

    Se a fonte de publicação for um branch e um diretório, o arquivo de entrada deverá estar no nível superior do diretório de origem no branch de origem. Por exemplo, se a fonte de publicação for o diretório /docs do branch main, o arquivo de entrada deverá estar no diretório /docs de um branch chamado main.

    Se a fonte de publicação for um fluxo de trabalho do GitHub Actions, o artefato que você implantar precisará incluir o arquivo de entrada na parte superior do artefato. Em vez de adicionar o arquivo de entrada ao repositório, há a opção de fazer com que o fluxo de trabalho do GitHub Actions gere esse arquivo de entrada ao ser executado.

  • O nome do arquivo index.html diferencia maiúsculas de minúsculas. Por exemplo, Index.html não funcionará.

  • O nome do arquivo deve ser index.html, não index.HTML ou qualquer outra variação.

Conteúdo do diretório

Verifique se o conteúdo do diretório está no diretório raiz.

Repositório

Verifique se o repositório atende aos requisitos a seguir.

  • O branch que você está usando para publicar o site deve ser main ou o branch padrão.
  • O repositório deve ter um commit enviado a ele por alguém com as respectivas permissões de administrador, como o proprietário do repositório.
  • Mudar a visibilidade do repositório de público para privado ou vice-versa mudará a URL do site do GitHub Pages, o que resulta em links desfeitos até a reconstrução do site.
  • Se você estiver usando um repositório privado para o site GitHub Pages, verifique se sua assinatura do GitHub Pro, GitHub Team ou GitHub Enterprise Cloud ainda está ativa. Se você renovar o plano, o site GitHub Pages será reimplantado automaticamente. Caso contrário, você poderá alterar a visibilidade do seu repositório para público a fim de continuar usando o GitHub Pages gratuitamente.

Se o erro 404 continuar sendo exibido, inicie uma discussão da GitHub Community na categoria Pages.