Solución de errores 404
En esta guía encontrarás varias razones comunes por las que puede que veas un error 404 al compilar el sitio GitHub Pages.
- Página de estado de GitHub
- Caché del navegador
- Archivo
index.html
- Contenido del directorio
- Repositorio
Página Estado de GitHub
Si ves un error 404 al compilar un sitio GitHub Pages, lo primero que debes hacer es comprobar la página Estado de GitHub para saber si hay incidentes activos.
Caché del navegador
Si el sitio GitHub Pages es privados y ves un error 404, es posible que tengas que borrar la caché del explorador. Para obtener más información acerca de limpiar tu caché, consulta la documentación de tu navegador.
Archivo index.html
GitHub Pages buscará un archivo index.html
como archivo de entrada para el sitio.
-
Asegúrate de tener un archivo
index.html
en el repositorio del sitio en GitHub Enterprise Server. Para obtener más información, vea «Crear un sitio de Páginas de GitHub». -
El archivo de entrada debe estar en el nivel superior del origen de publicación elegido. Por ejemplo, si el origen de publicación es el directorio
/docs
de la ramamain
, el archivo de entrada debe estar en el directorio/docs
de una rama denominadamain
.Si el origen de publicación es una rama y un directorio, el archivo de entrada debe estar en el nivel superior del directorio de origen de la rama de origen. Por ejemplo, si el origen de publicación es el directorio
/docs
de la ramamain
, el archivo de entrada debe estar en el directorio/docs
de una rama denominadamain
.Si la fuente de publicación es un flujo de trabajo de GitHub Actions, el artefacto que implementes debe incluir el archivo de entrada en el nivel superior del artefacto. En lugar de agregar el archivo de entrada al repositorio, puedes decidir que el flujo de trabajo de GitHub Actions genere el archivo de entrada cuando se ejecute el flujo de trabajo.
-
El nombre del archivo
index.html
distingue mayúsculas de minúsculas. Por ejemplo,Index.html
no funcionará. -
El nombre del archivo debe ser
index.html
, noindex.HTML
, ni otra variación del mismo.
Contenido del directorio
Comprueba que el contenido del directorio se encuentra en el directorio raíz.
Repositorio
Comprueba si el repositorio cumple los siguientes requisitos.
- La rama que uses para publicar el sitio debe ser
main
o la rama predeterminada. - El repositorio debe tener una confirmación insertada por alguien con permisos de administrador en el mismo, como su propietario.
- Cambiar la visibilidad del repositorio de público a privado o viceversa cambiará la dirección URL del sitio GitHub Pages, lo que dará lugar a vínculos rotos hasta que se vuelva a generar el sitio.
Si sigues recibiendo un error 404, inicia una discusión de GitHub Community en la categoría Pages.