Résolution des erreurs 404 pour les sites Pages

Qui peut utiliser cette fonctionnalité ?

Pages est disponible dans les référentiels publics avec Free et Free pour les organisations, et dans les référentiels publics et privés avec Pro, Team, Enterprise Cloud et Enterprise Server. Pour plus d’informations, consultez Plans de .

Dans ce guide, vous allez trouver des raisons courantes pour lesquelles vous pouvez voir une erreur 404 lors de la création de votre site Pages.

Si vous voyez une erreur 404 lors de la création d’un site Pages, commencez par rechercher s’il y a des incidents actifs dans la page État de .

Vérifiez que les enregistrements DNS de sont configurés correctement avec votre fournisseur DNS. Pour plus d’informations, consultez Gestion d’un domaine personnalisé pour votre site Pages.

Si votre site Pages est privé et que vous voyez une erreur 404, il peut être nécessaire d’effacer le cache de votre navigateur. Pour plus d’informations sur l’effacement de votre cache, consultez la documentation de votre navigateur.

Pages va rechercher un fichier index.html comme fichier d’entrée pour votre site.

  • Assurez-vous d'avoir un fichier index.html dans le référentiel de votre site sur . Pour plus d’informations, consultez « Création d’un site Pages ».

  • Le fichier d’entrée doit se trouver au plus haut niveau de la source de publication choisie. Par exemple, si votre source de publication est le répertoire /docs de la branche main, votre fichier d’entrée doit se trouver dans le répertoire /docs sur une branche appelée main.

    Si votre source de publication est une branche et un répertoire, le fichier d’entrée doit être au plus haut niveau du répertoire source sur la branche source. Par exemple, si votre source de publication est le répertoire /docs de la branche main, votre fichier d’entrée doit se trouver dans le répertoire /docs sur une branche appelée main.

    Si votre source de publication est un workflow Actions, l’artefact que vous déployez doit inclure le fichier d’entrée au niveau supérieur de l’artefact. Au lieu d’ajouter le fichier d’entrée à votre dépôt, vous pouvez choisir de faire en sorte que votre workflow Actions génère votre fichier d’entrée quand il s’exécute.

  • Le nom du fichier index.html respecte la casse. Par exemple, Index.html ne va pas fonctionner.

  • Le nom du fichier doit être index.html, et non pas index.HTML ou une autre variante.

Vérifiez que le contenu de votre répertoire se trouve dans le répertoire racine.

Si vous utilisez un domaine personnalisé, vérifiez qu’il est configuré correctement. Pour plus d’informations, consultez « À propos des domaines personnalisés et des pages  ».

  • L’enregistrement CNAME doit toujours pointer vers <USER>..io ou vers <ORGANIZATION>..io, à l’exclusion du nom du dépôt. Pour plus d’informations sur la création de l’enregistrement approprié, consultez la documentation de votre fournisseur DNS.
  • Si vous êtes en mesure d’accéder à votre page d’accueil, mais que vous rencontrez des liens rompus tout au long du processus, c’est probablement parce que vous n’aviez pas de nom de domaine personnalisé auparavant ou que vous revenez à un nom de domaine non personnalisé. Dans ce cas, la modification du chemin de routage ne lance pas une reconstruction de la page. La solution recommandée est de vérifier que votre site se reconstruit automatiquement lors de l’ajout ou de la suppression d’un nom de domaine personnalisé. Ceci peut impliquer la configuration d’un créateur de commit et la modification des paramètres de nom de domaine personnalisé.

Vérifiez si votre dépôt répond aux exigences suivantes.

  • La branche que vous utilisez pour publier votre site doit être main ou la branche par défaut.
  • Un commit doit être envoyé (push) au dépôt par une personne disposant d’autorisations d’administrateur pour le dépôt, comme le propriétaire du dépôt.
  • Le basculement de la visibilité du dépôt de public à privé, ou vice versa, change l’URL de votre site Pages, ce qui aboutit à des liens rompus jusqu’à ce que le site soit reconstruit.
  • Si vous utilisez un référentiel privé pour le site Pages, vérifiez si votre abonnement Pro, Team ou Enterprise Cloud est toujours actif. Si vous renouvelez le plan, le site Pages sera automatiquement redéployé. Sinon, vous pouvez modifier la visibilité de votre référentiel sur public pour continuer à utiliser Pages gratuitement.

Si vous recevez toujours une erreur 404, démarrez une discussion Community dans la catégorie Pages.