HTTP 504 — Gateway Timeout
Domaine : HTTPPriorité : Haute
Que signifie cette erreur ?
Une passerelle n’a pas reçu de réponse du serveur en amont dans le délai configuré.
Causes probables
- requête backend trop lente
- base de données bloquée
- timeout proxy trop court
- perte réseau entre proxy et application
Vérifications et résolution
- Mesurer le temps de réponse direct du backend
- Contrôler les requêtes lentes et dépendances
- Comparer les timeouts proxy et applicatifs
- Vérifier les erreurs réseau entre les couches
Précaution : Augmenter le timeout sans traiter la lenteur du backend ne fait que déplacer le problème.
← Revenir à la base des codes d’erreur
Diagnostic HTTP 504 : où se produit le timeout ?
- Relevez l’URL, l’heure exacte et la durée au bout de laquelle apparaît le code HTTP 504.
- Mesurez le temps de réponse du serveur d’application depuis le reverse proxy, sans passer par le frontal public, avec une requête représentative.
- Examinez les requêtes SQL lentes, files d’attente, services tiers et limites de ressources pouvant retarder la réponse.
- Vérifiez les limites de temps côté proxy, serveur HTTP, application et load balancer ; identifiez lequel expire en premier.
- Corrigez les lenteurs et les ressources en cause, puis ne modifiez les délais d’attente que lorsqu’ils sont réellement inadaptés au comportement normal du service.
Erreur 504 ou erreur 502 : comment les distinguer ?
HTTP 504 signifie qu’une passerelle attend une réponse trop longtemps. HTTP 502 signifie qu’elle ne reçoit pas de réponse amont valide. Une application saturée peut entraîner les deux, mais il faut d’abord distinguer absence de réponse et réponse défectueuse dans les journaux.
Attention
Augmenter systématiquement les timeouts peut masquer une panne applicative et accroître la consommation des ressources. Conservez une trace des paramètres avant modification.