Dépannage

Si vous rencontrez des problèmes avec votre site statique, vous trouverez ci-dessous des conseils et des solutions pour les erreurs les plus courantes.

Erreur 403

Si le déploiement de votre site se termine sans erreur, mais que vous voyez une erreur 403 quand vous essayez de visiter le site dans votre navigateur, voici quelques points à vérifier :

1. Si votre site dépend d’une étape de construction, la commande de construction (réglages > détails basiques) est-elle définie et correcte ?
2. Le répertoire de publication est-il correct ?
3. Vos autorisations de fichiers* sont-elles correctes ? Nous recommandons généralement les autorisations suivantes pour les sites statiques :
   • Répertoires : 755
   • Fichiers : 644

*Les autorisations de fichiers contrôlent qui peut :

• Lire : Voir le contenu d’un fichier ou voir les fichiers d’un répertoire.
• Écrire : Modifier un fichier, ou ajouter ou supprimer des fichiers dans un répertoire.
• Exécuter : Utiliser un fichier et/ou l’exécuter en tant que script, ou accéder à un répertoire et exécuter des fonctions et des commandes.

Chaque fichier et chaque répertoire dispose de son propre ensemble de réglages, affiché sous la forme d’un nombre à trois chiffres. Chaque chiffre indique le niveau d’autorisation pour chaque catégorie (lecture, écriture et exécution) affichée ci-dessus.

Erreur 404

Si le déploiement de votre site se termine sans erreur mais que vous voyez une erreur 404 lorsque vous essayez de visiter le site dans votre navigateur, il y a quelques points à vérifier :

1. Si votre site dépend d’une étape de construction, la commande de construction (Réglages > Détails de base) est-elle remplie et correcte ?
2. Le répertoire de publication est-il correct ?
3. Votre répertoire est-il compatible avec Static Site Hosting? Il doit contenir soit :
   1. Un framework de site statique qui utilise Node.js pour l’étape de construction.
   2. Ou des fichiers statiques tels que HTML, CSS et Javascript, qui ne nécessitent pas d’étape de construction (laissez la commande Build vide).

La commande Build indique à notre système comment assembler votre site, et le répertoire Publish est le sous-répertoire où se trouvent les fichiers du site fini, par rapport à la racine de votre répertoire. Il est essentiel de remplir ces champs correctement si votre site dépend d’une étape de construction. Cela vous permettra de vous assurer que votre site est construit et servi comme vous le souhaitez. Si la commande Build n’est pas renseignée, le système peut indiquer que le déploiement est terminé, mais il ne fera que télécharger le contenu non construit de votre répertoire.

Version de Node incorrecte

Lorsque vous saisissez une commande de construction pour votre site, vous pouvez sélectionner la version de Node à utiliser. Si vous sélectionnez une version incorrecte, le déploiement échouera et il y aura une erreur dans le journal de construction et de déploiement indiquant qu’une version différente de Node.js est nécessaire, similaire à ceci :

"Build project": error [email protected]: The engine "node" is incompatible with this module. Expected version "16.14.0". Got "16.20.0"

Vérifiez les réglages de votre site statique, modifiez la version de Node si nécessaire, et déployez à nouveau manuellement le site (cliquez sur Déployer maintenant sur la page Déploiements).

Impossible de déterminer le gestionnaire de paquets

Si un problème survient avec la commande de construction ou le fichier de configuration, vous pouvez voir l’erreur suivante :

Erreur : Impossible de déterminer le gestionnaire de paquets

Cette erreur est généralement due à une commande de construction incorrecte ou à un fichier package.json manquant ou mal configuré. Voici quelques points à vérifier :

1. 1. La commande de construction (réglages > détails basiques) est-elle définie et correcte ?
   2. Le fichier package.json se trouve-t-il dans votre dépôt git ?
   3. Le fichier package.json est-il configuré correctement, y compris toute version conflictuelle de Node ? Par exemple, vous avez peut-être choisi la version 18.16.0 de Node quand vous avez ajouté le site statique, mais dans le fichier package.json, vous avez peut-être défini la version de Node à quelque chose de différent, comme dans l’exemple suivant :
      Copy

      "engines": {
      "node": ">=20.0.0"
      },