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 obter mais informações, 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 branchmain
, o arquivo de entrada deverá estar no diretório/docs
de um branch chamadomain
.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 branchmain
, o arquivo de entrada deverá estar no diretório/docs
de um branch chamadomain
.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ãoindex.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.