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 Status do GitHub
- Cache do navegador
- Arquivo
- Conteúdo do diretório
- Repositório
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
O GitHub Pages procurará um arquivo como o arquivo de entrada para o site.
-
Tenha um arquivo no repositório do site no GitHub. Para saber mais, confira AUTOTITLE.
-
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 do branch , o arquivo de entrada deverá estar no diretório de um branch chamado .
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 do branch , o arquivo de entrada deverá estar no diretório de um branch chamado .
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 é sensível a maiúsculas e minúsculas. Por exemplo, não funcionará.
-
O nome do arquivo deve ser , não 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 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.