Skip to main content

GitHub AE es una versión limitada en este momento.

Solución de errores 404 en sitios de GitHub Pages

Esta guía te ayudará a solucionar los motivos comunes por los que puede aparecer un error 404.

GitHub Pages está disponible en repositorios internos y privados con GitHub AE. GitHub Pages se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y GitHub Enterprise Server.

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 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 AE. 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 rama main, el archivo de entrada debe estar en el directorio /docs de una rama denominada main.

  • 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, no index.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.