Dépannage des erreurs 5xx Fasterize

Introduction

Les erreurs HTTP 5xx signalent un problème survenu côté serveur. Elles peuvent être liées à votre serveur d’origine, au CDN, ou à la plateforme Fasterize elle-même. Ce guide vous aide à diagnostiquer et résoudre ces erreurs en fonction du code reçu.

1. Avant toute chose : recueillir les bonnes informations

Pour toute investigation, commencez par rassembler les éléments suivants :

• Le code d’erreur HTTP précis (ex : 500, 504, 524)
• L'URL concernée
• L'heure exacte (avec fuseau horaire)
• L'adresse IP du navigateur
• Les en-têtes HTTP utiles (ex : X-Fstrz, X-unique-id, Request ID)

💡 Ces données sont essentielles pour votre hébergeur ou le support Fasterize. Comment récupérer le requestID ?

2. Erreurs côté serveur d’origine

🔧 500 : Internal Server Error

Une erreur 500 indique un problème avec votre serveur web d'origine. Error establishing database connection est un message d'erreur HTTP 500 courant généré par votre serveur web d'origine.

Dans ce cas, Fasterize a réussi à se connecter au serveur d'origine mais a reçu une erreur 500 en retour. L'entête de réponse HTTP X-Fstrz ajouté par Fasterize a alors la valeur stc, Z, p.

💡 Note : pour simplifier la résolution des incidents, Fasterize n'utilise pas le code d'erreur 500.

Résolution :

• Donnez des informations détaillées à votre fournisseur d’hébergement pour qu'il vous aide à résoudre le problème. Il s'agit généralement d'une erreur applicative.

🔧 502 / 504 : Bad Gateway / Gateway Timeout (depuis l’origine)

Une erreur HTTP 502 ou 504 peut arriver de deux façons :

• lorsque l'erreur est émise par votre serveur web d'origine
• lorsque notre CDN est incapable d'établir le contact avec le moteur d'optimisation

502/504 depuis votre serveur web d'origine

Dans ce cas, Fasterize a réussi à établir la connexion à l'origine, mais l'origine a renvoyé une réponse avec le code d'erreur 502 ou 504. La page renvoyée ne mentionne alors ni Fasterize, ni de CDN (ex: Cloudfront). L'entête X-Fstrz a alors la valeur stc, Z, p.

Résolution :

• Contactez votre fournisseur d’hébergement pour trouver la cause :
  • Vérifiez que le serveur d'origine répond aux requêtes pour le nom d'hôte et le domaine de l’URL visitée.
  • Vérifiez la présence de charges de serveur excessives, crashs ou pannes réseau.
  • Identifiez les applications ou services bloqués ou expirés.

🔧 503 : Service Unavailable

L'erreur HTTP 503 se produit lorsque votre serveur web d'origine est surchargé. Ce statut n'est jamais émis par Fasterize. Comme pour les erreurs 500, l'entête X-Fstrz a la valeur stc, Z, p ou ecc, Z, p.

Résolution :

• Contactez votre fournisseur d’hébergement pour vérifier s'il limite le débit ou si votre origine est en maintenance.

🔧 542 : Connexion impossible à l’origine

Une erreur 542 est générée par Fasterize quand celui-ci n'arrive pas à accéder aux serveurs web d'origine. Plusieurs raisons possibles :

• Le serveur d'origine renseigné dans la configuration est incorrect
• Le serveur est en panne ou injoignable
• Il bloque les connexions de Fasterize
• Le certificat TLS est invalide
• La négociation TLS échoue (TLS/ciphers incompatibles)
• La résolution DNS échoue

Résolution :

• Contactez l'administrateur du site ou l’hébergeur pour :
  • Vérifier la configuration
  • Consulter les logs d'erreurs
  • S'assurer que les IP Fasterize ne sont pas bloquées
  • Whitelister les plages d'IP Fasterize

🔧 544 : Réponse trop lente de l’origine

Une erreur 544 est générée si Fasterize n'arrive pas à se connecter à l'origine dans un délai de 20 secondes, ou si aucune réponse HTTP n’est reçue en 175 secondes.

Résolution :

• Contactez votre hébergeur pour exclure les causes suivantes :
  • Processus long sur le serveur (ex : export de catalogue)
  • Surcharge du serveur
• Vérifiez les logs (Apache, Nginx) pour comprendre les lenteurs
• Si besoin, exécutez ces processus hors de Fasterize (sous-domaine non proxyfié)

3. Erreurs côté CDN ou Fasterize

🌐 502 / 504 : depuis le CDN (ex : Cloudfront)

Erreur 502/504 affichée par le CDN lorsque celui-ci ne parvient pas à contacter Fasterize.

Résolution :

• Consultez https://status.fasterize.com pour vérifier l'état du service
• Si aucun incident, contactez le support avec :
  • Heure précise
  • URL concernée
  • Numéro de Request ID
  • Adresse IP du navigateur

⚙️ 521 : Configuration introuvable

L'erreur 521 signifie que la plateforme Fasterize n'a pas trouvé de configuration correspondant au nom de domaine.

Résolution :

• Contactez le support Fasterize avec :
  • Heure
  • URL
  • X-unique-id
  • Adresse IP

🔁 524 : Boucle de redirection

L'origine de la configuration pointe sur Fasterize au lieu du serveur d'origine, entraînant une boucle.

Résolution :

• Contactez le support Fasterize avec :
  • Heure
  • URL
  • X-unique-id
  • Adresse IP

🛠️ 53x / 59x : Erreur interne Fasterize

Une erreur interne s'est produite sur la plateforme Fasterize.

Résolution :

• Vérifiez https://status.fasterize.com
• Si aucun incident n'est listé, contactez le support avec :
  • Heure
  • URL
  • X-unique-id
  • Adresse IP

🧪 543 : Prerender non disponible

Cette erreur peut survenir lorsque Chrome effectue un prerender via les Speculation Rules. Si la page n’est pas en cache chez Fasterize, une 543 est renvoyée pour éviter un appel inutile vers l’origine.

Résolution :

• Aucun impact utilisateur
• Le clic déclenchera un chargement normal
• Optionnel : ajuster les règles de speculation si besoin

Conclusion

Les erreurs 5xx peuvent avoir des causes variées. Ce guide vous aide à identifier la source du problème et à agir rapidement. Pensez toujours à fournir les bons éléments pour accélérer le diagnostic, que ce soit avec votre hébergeur ou notre support.

‍