Signification
Une passerelle ou un proxy n'a pas reçu à temps la réponse du serveur amont.
Causes courantes
- Requêtes de base de données ou appels d'API externes lents
- Délai du proxy plus court que le temps de traitement
- Serveur amont injoignable à cause de problèmes réseau
Comment corriger
Côté client ou visiteur
Réessayez plus tard ; pour les opérations longues, demandez si l'API propose un traitement asynchrone.
Côté propriétaire du site ou de l’API
Accélérez le chemin lent ou déplacez-le vers une tâche d'arrière-plan ; n'augmentez les délais du proxy (proxy_read_timeout) que jusqu'à des valeurs réalistes.
Exemple de réponse
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0Spécification
FAQ
› Comment corriger 504 Gateway Timeout dans nginx ?
Trouvez pourquoi l'amont est lent ; si de longues requêtes sont normales, augmentez proxy_read_timeout et le délai du serveur d'application ensemble.
› Qui renvoie la 504, mon application ou le proxy ?
Le proxy, le répartiteur de charge ou le CDN placé devant votre application, après l'avoir attendue trop longtemps.