Une 504 Gateway Timeout signifie que le serveur qui transmet votre requête ne reçoit pas de réponse à temps du serveur en amont. Cela est généralement dû à un script lent, une base de données surchargée, un proxy mal configuré ou un plugin qui bloque. Dans cet article, vous découvrirez comment identifier la cause et quelles mesures prendre pour résoudre définitivement l’erreur.
Qu’est-ce qu’une 504 Gateway Timeout exactement
Dans de nombreux environnements d’hébergement, il existe une couche intermédiaire entre le visiteur et votre site web : un reverse proxy, un répartiteur de charge ou une couche de mise en cache. Cette couche transmet la requête au serveur web ou à l’application qui construit réellement la page. Si cela prend trop de temps, la couche intermédiaire renvoie une 504 au lieu de continuer à attendre. La différence avec une erreur 500 est importante : avec une 504, il n’y a pas de message d’erreur provenant de votre application elle-même, mais simplement aucune réponse dans le délai imparti.
Causes fréquentes
Une 504 peut avoir plusieurs causes, souvent une combinaison de celles-ci :
- Requêtes de base de données lentes qui restent bloquées longtemps, par exemple en raison d’index manquants ou d’un ensemble de données trop volumineux.
- Plugins ou thèmes qui effectuent des requêtes externes lourdes (API, flux) qui ne répondent pas à temps.
- Paramètres de délai d’expiration trop bas dans PHP, le serveur web ou un proxy/CDN en amont.
- Serveur surchargé en raison d’un pic de charge, de tâches cron s’exécutant simultanément ou de ressources insuffisantes.
- Reverse proxy mal configuré entre le CDN et l’origine, entraînant un mauvais acheminement des requêtes.
- Problèmes DNS ou réseau rendant le serveur en amont inaccessible ou trop lent à répondre.
Plan d’action pour résoudre l’erreur
Vérifiez les journaux d’erreurs
Consultez les journaux d’erreurs de votre environnement d’hébergement. Dans Plesk, vous les trouverez dans les paramètres du site web sous « Fichiers journaux ». Vous y verrez souvent quel script ou quelle requête bloque.
Désactivez temporairement les plugins et thèmes
Sous WordPress, désactivez un par un les plugins récemment ajoutés pour déterminer si un plugin spécifique est à l’origine de la réponse lente.
Vérifiez la base de données
Utilisez phpMyAdmin ou un outil en ligne de commande pour détecter les requêtes lentes. Optimisez les tables et ajoutez des index si nécessaire.
Augmentez ou vérifiez les paramètres de délai d’expiration
Ajustez les valeurs de délai d’expiration de PHP et du serveur web si certains scripts ont structurellement besoin de plus de temps, mais recherchez d’abord la cause sous-jacente plutôt que d’utiliser cela comme solution permanente.
Vérifiez les connexions externes
Si votre site web dépend d’API externes, vérifiez si ces services répondent eux-mêmes lentement. Une source externe lente peut bloquer l’ensemble de la page.
Contactez le support
Si vous ne trouvez pas de solution, contactez votre hébergeur. Il pourra vérifier la charge du serveur et les connexions réseau que vous ne pouvez pas consulter vous-même.
Prévenir la 504 à l’avenir
Mieux vaut prévenir que guérir. Assurez-vous de disposer d’une sauvegarde à jour avant d’effectuer des modifications, afin de pouvoir toujours revenir à une version fonctionnelle. Maintenez les plugins, thèmes et le noyau du CMS à jour, et surveillez la disponibilité de votre site web afin d’être immédiatement averti en cas de problème. Un environnement disposant de ressources suffisantes et d’un serveur bien configuré, comme vous le retrouverez chez webhosting avec des logiciels serveur modernes, évite que des scripts lents ne provoquent directement un délai d’expiration complet. Si vous envisagez tout de même de changer d’hébergeur après des problèmes répétés, découvrez comment fonctionne le fait de passer chez Tandata.
Questions fréquentes
Une erreur 504 est-elle la même chose qu’une erreur 502 ?
Non. Une 502 Bad Gateway signifie que le proxy a reçu une réponse invalide, tandis qu’une 504 signifie qu’aucune réponse n’est arrivée dans le délai imparti.
Puis-je résoudre une erreur 504 moi-même sans connaissances techniques ?
Une partie des étapes, comme désactiver des plugins, vous pouvez les faire vous-même. Pour les problèmes de serveur plus profonds, il est conseillé de contacter votre hébergeur.
Une 504 se produit-elle aussi pour l’e-mail ou seulement pour les sites web ?
L’erreur se produit spécifiquement pour les requêtes web via HTTP. Les problèmes d’e-mail se manifestent différemment, par exemple sous forme de messages de rebond.
Conclusion
Une 504 Gateway Timeout indique presque toujours un serveur en amont, une base de données ou une connexion externe lente. En vérifiant les journaux, en testant les plugins et en optimisant la base de données, vous résolvez la plupart des cas vous-même. Si le problème persiste, un environnement d’hébergement plus stable est souvent la solution la plus durable.