504

Ce qui se passe réellement

Le serveur proxy/gateway a transmis la requête au backend mais n'a pas reçu de réponse avant l'expiration du timeout. Le backend est en cours de traitement (requête longue, base de données lente, API externe qui ne répond pas) mais n'a pas terminé à temps. Différent du 502 : ici le backend est vivant mais trop lent.

Solutions

1. 1Rafraîchir la page et réessayer — la requête était peut-être exceptionnellement lente.
2. 2Si c'est votre serveur : augmenter le timeout du proxy (proxy_read_timeout 300s dans Nginx).
3. 3Optimiser les requêtes backend lentes (profiler la base de données, ajouter des index).
4. 4Implémenter un traitement asynchrone pour les opérations longues (file de messages, webhooks).
5. 5Vérifier la latence vers les services dépendants (base de données, APIs tierces).