Code erreur HTTP 504 Gateway Timeout : signification et que faire

À surveiller

Le code HTTP 504 Gateway Timeout indique qu'un serveur intermédiaire (passerelle ou proxy) n'a pas reçu de réponse à temps du serveur en amont. La requête n'a pas abouti, mais la panne est du côté serveur et souvent temporaire.

Que signifie le code 504 ?

Dans l'architecture du web, une requête peut transiter par plusieurs serveurs avant d'atteindre sa destination : un proxy inverse, un équilibreur de charge, un CDN ou une passerelle API. Si l'un de ces intermédiaires envoie la requête à un serveur cible et que ce serveur ne répond pas dans le délai configuré, l'intermédiaire renvoie un code 504 au navigateur. Ce code se distingue du 502 (Bad Gateway), qui signale une réponse reçue mais invalide, et du 503 (Service Unavailable), qui indique que le serveur lui-même est indisponible.

Causes probables

  • Serveur cible surchargé ou en cours de redémarrage.
  • Délai d'attente (timeout) du proxy trop court par rapport au temps de traitement du serveur cible.
  • Problème réseau entre la passerelle et le serveur cible (coupure, latence élevée).
  • Incident ou maintenance planifiée sur le serveur d'application en aval.
  • Erreur de configuration du serveur proxy ou de la passerelle.

Comment résoudre le code 504

  1. Patienter et actualiser la page. Appuyez sur F5 ou sur le bouton d'actualisation du navigateur. Une indisponibilité temporaire se résout souvent d'elle-même en quelques minutes.
  2. Vider le cache du navigateur. Si l'erreur persiste, videz le cache et les cookies du navigateur, puis rechargez la page.
  3. Vérifier l'état du service. Consultez la page de statut officielle du site ou service concerné pour savoir si un incident est signalé.
  4. Essayer depuis un autre réseau. Testez la page depuis un réseau différent (données mobiles par exemple) pour écarter une origine locale.
  5. Contacter l'hébergeur (si vous êtes webmestre). Vérifiez les journaux du proxy ou de l'équilibreur de charge et la disponibilité du serveur d'application en aval. Augmentez si nécessaire le délai timeout configuré.

Quand faire appel à un professionnel

Si le code 504 persiste au-delà de quelques minutes sur un site tiers, le problème relève de l'équipe technique du service. Si vous gérez votre propre infrastructure, vérifiez la configuration du timeout upstream et la disponibilité du serveur d'application.

Questions fréquentes

Quelle est la différence entre un code 504 et un code 502 ?
Le code 502 (Bad Gateway) signifie que la passerelle a bien reçu une réponse du serveur cible, mais que cette réponse était invalide ou mal formée. Le code 504 (Gateway Timeout) signifie que la passerelle n'a reçu aucune réponse dans le délai imparti.
Un code 504 vient-il de mon ordinateur ?
Non : un code 504 indique un problème entre des serveurs sur le réseau. Votre ordinateur et votre connexion ne sont pas en cause.
Combien de temps doit-on attendre avant de réessayer ?
Quelques minutes suffisent en général pour une surcharge passagère. Si le code 504 persiste plus de 15 à 30 minutes, c'est un incident côté serveur qui nécessite l'intervention de l'équipe technique du site.

Autres codes Serveur / HTTP

500Code d'erreur HTTP 500 Internal Server Error : signification et causes 403Code erreur HTTP 403 Forbidden : accès interdit, signification et solutions 502Code erreur HTTP 502 Bad Gateway : passerelle invalide, signification et solutions 503Code erreur HTTP 503 Service Unavailable : serveur indisponible, signification et solutions 400Code erreur HTTP 400 Bad Request : signification et solutions 404Code erreur 404 HTTP : signification, causes et que faire 401Code erreur HTTP 401 Unauthorized : signification et solution 501Code erreur HTTP 501 Not Implemented : signification et solution 402Code erreur HTTP 402 Payment Required : signification 407Code HTTP 407 Proxy Authentication Required : signification et solution 408Code erreur HTTP 408 Request Timeout : signification et causes 409Code HTTP 409 Conflict : signification et résolution

Source : MDN Web Docs (Mozilla) · relevé le 06/07/2026.