Vous visitez votre site et vous voyez un écran blanc avec trois mots: «502 Bad Gateway». Le trafic arrive, mais les visiteurs voient une erreur au lieu du contenu. Les ventes s’arrêtent, le référencement chute et vous perdez du temps à deviner.

L’erreur 502 a l’air inquiétante, mais en réalité il s’agit simplement d’un problème de communication entre serveurs. Votre site n’est pas cassé, les données n’ont pas disparu et, dans la plupart des cas, la correction prend entre cinq et quinze minutes. Voici un guide pas à pas qui vous emmène des vérifications les plus simples jusqu’aux diagnostics plus poussés.

💡 Aperçu rapide:

• Rafraîchissez la page et vérifiez si le serveur d’hébergement est hors service
• Videz le cache de votre navigateur et désactivez temporairement le CDN
• Si l’erreur persiste, désactivez les plugins via FTP et vérifiez le thème
• Réinitialisez le fichier .htaccess et contactez votre hébergeur quand tout le reste a échoué

Qu’est-ce qu’une erreur 502 Bad Gateway

Quand vous ouvrez un site, le navigateur envoie une requête HTTP. Côté serveur, un proxy inverse (Nginx, Apache) la reçoit et répartit les requêtes entre le serveur d’application (PHP), la base de données, le serveur web statique et le CDN. Chaque nœud traite sa part et renvoie le résultat au serveur proxy. Le proxy assemble la réponse et la délivre au navigateur, et la page se charge.

Une erreur 502 se produit quand l’un des serveurs de cette chaîne renvoie une réponse invalide au serveur proxy. Le proxy ne peut pas assembler la page et affiche «Bad Gateway». Le navigateur signale honnêtement que la passerelle entre les serveurs a reçu quelque chose d’inattendu.

Visuellement, l’erreur peut prendre différentes formes: «502 Bad Gateway», «502 Service Temporarily Overloaded», «HTTP 502», «Nginx 502 Bad Gateway», «Proxy Error». L’essence est la même: quelque part dans la chaîne, il y a une rupture.

Pourquoi l’erreur 502 se produit

Les causes sont presque toujours côté serveur, mais parfois vos propres actions sur le site la déclenchent:

• Surcharge du serveur. Un pic de trafic soudain épuise les ressources d’hébergement et les processus PHP n’arrivent pas à suivre la file de requêtes.
• Plugin ou thème défectueux. Un code qui provoque une erreur PHP fatale interrompt la réponse du serveur d’application et le proxy ne reçoit rien.
• Problème de CDN. Cloudflare, KeyCDN ou un autre service de diffusion de contenu n’arrive pas à se connecter au serveur d’origine et renvoie une 502.
• Enregistrements DNS incorrects. Après un changement d’hébergeur ou une mise à jour des serveurs DNS, les enregistrements ne se sont pas encore propagés, le site est donc temporairement inaccessible.
• Fichier.htaccess corrompu. Une syntaxe cassée ou des règles de réécriture conflictuelles perturbent le traitement des requêtes.
• Limite de mémoire PHP atteinte. Un plugin ou un script lourd consomme toute la mémoire disponible et le processus plante.

Parcourons maintenant chaque correction étape par étape, de la plus rapide à la plus complexe.

Étape 1. Rafraîchir la page

La première chose à faire, la plus simple: appuyez sur F5 ou Ctrl+R. Si l’erreur a été causée par un bref problème serveur, la requête répétée aboutira. Essayez d’ouvrir le site dans un autre navigateur ou en données mobiles, cela permet d’écarter un problème de votre côté.

Vérifiez si le site fonctionne pour le reste du monde en utilisant isup.me ou Down For Everyone Or Just Me. Si le service indique que le site est hors service uniquement pour vous, le problème est local, passez à la suite. Si le site est indisponible pour tout le monde, le serveur d’hébergement a probablement planté ou un blocage a été appliqué au niveau du fournisseur.

Étape 2. Vider le cache du navigateur

Le navigateur met en cache non seulement les images et les styles, mais aussi les réponses erronées du serveur. Un rafraîchissement forcé (Ctrl+F5 sur Windows, Cmd+Shift+R sur macOS) oblige le navigateur à redemander la page en ignorant le cache local.

Si le rafraîchissement forcé n’a pas aidé, videz complètement le cache. Dans Chrome: Paramètres → Confidentialité et sécurité → Effacer les données de navigation → «Images et fichiers en cache». Nous avons détaillé les instructions pour différents navigateurs et pour vider le cache côté WordPress dans un guide séparé.

Étape 3. Désactiver temporairement le CDN

Les réseaux de diffusion de contenu comme Cloudflare ou KeyCDN font passer le trafic par leurs propres serveurs. Si une panne survient côté CDN ou si une règle de pare-feu incorrecte est configurée, les visiteurs verront une 502 même si le serveur d’origine fonctionne parfaitement.

Pour tester cette hypothèse, mettez le CDN en pause dans son panneau de contrôle. Cloudflare: allez dans Overview → Pause Cloudflare. KeyCDN et services similaires: cherchez le bouton Disable ou Pause dans le panneau. Après la désactivation, rafraîchissez votre site. Si l’erreur disparaît, le problème vient du CDN, contactez leur support.

Pendant que le CDN est désactivé, le site fonctionne directement depuis votre hébergement, la vitesse peut donc légèrement baisser, mais la disponibilité sera rétablie. Nous avons comparé les services de CDN populaires et leur configuration dans un article sur les CDN gratuits pour WordPress.

Étape 4. Vérifier les paramètres DNS

Après un changement d’hébergeur ou une mise à jour des enregistrements NS, les informations DNS se propagent sur le réseau sur une période allant de quelques heures à 48 heures. Pendant ce temps, certains visiteurs peuvent atterrir sur l’ancien serveur, qui ne répond pas ou répond incorrectement.

Si vous avez récemment migré votre site, attendez 24 heures, c’est généralement suffisant. Par ailleurs, videz votre cache DNS local: sur Windows, ouvrez l’invite de commandes et exécutez ipconfig /flushdns; sur macOS, exécutez sudo dscacheutil -flushcache et sudo killall -HUP mDNSResponder. Ensuite, rafraîchissez la page.

Étape 5. Désactiver les plugins via FTP

La cause la plus fréquente d’une 502 sur WordPress est un conflit de plugins. Un seul plugin problématique peut provoquer une erreur PHP fatale qui met tout le site hors service. Comme l’administration WordPress est inaccessible pendant une 502, vous devrez désactiver les plugins via le système de fichiers.

Connectez-vous au serveur via FTP (avec FileZilla, WinSCP) ou ouvrez le gestionnaire de fichiers dans cPanel. Allez dans le dossier racine du site (généralement public_html):

Entrez dans wp-content et trouvez le dossier plugins. Renommez-le, par exemple en plugins.old. Cela désactive instantanément tous les plugins d’un coup. Les données des plugins ne sont pas supprimées lors du renommage du dossier, les paramètres restent dans la base de données:

Rafraîchissez le site. S’il fonctionne, le problème vient de l’un des plugins. Renommez le dossier en plugins, allez dans l’administration et activez les plugins un par un, en vérifiant le site après chaque activation. Une fois le coupable trouvé, supprimez-le via FTP ou remplacez-le par une alternative.

Étape 6. Vérifier le thème actif

Si la désactivation des plugins n’a pas aidé, le suspect suivant est le thème. Un code incorrect dans functions.php ou un conflit avec la version de PHP peut également provoquer une erreur fatale et une 502.

Retournez dans le dossier racine du site → wp-content → themes. Trouvez le dossier du thème actif et renommez-le (par exemple, ajoutez .old à la fin):

WordPress basculera automatiquement sur le thème par défaut (Twenty Twenty-Four, Twenty Twenty-Five ou similaire). Rafraîchissez le site; si l’erreur a disparu, le problème vient du thème. Contactez le développeur du thème ou restaurez une sauvegarde. Après le diagnostic, renommez le dossier avec son nom d’origine.

Un algorithme détaillé pour vérifier les thèmes et localiser le code conflictuel est décrit dans le guide de dépannage des problèmes de thème WordPress.

Étape 7. Réinitialiser le fichier.htaccess

Un fichier .htaccess corrompu est une cause fréquente mais moins évidente de 502. Les règles de réécriture ajoutées par un plugin de cache ou un plugin de sécurité peuvent entrer en conflit. Une seule erreur de syntaxe dans ce fichier et le serveur renvoie une 502 sur toutes les requêtes.

Connectez-vous via FTP et localisez le fichier .htaccess dans le dossier racine du site. Téléchargez une copie de sauvegarde sur votre ordinateur, puis supprimez le fichier du serveur. Allez dans l’administration WordPress, dans Réglages → Permaliens, et cliquez sur «Enregistrer les modifications» (sans rien changer). WordPress créera un nouveau .htaccess avec un jeu de règles propre.

Si l’erreur est apparue juste après l’installation d’un plugin de cache (WP Rocket, W3 Total Cache, LiteSpeed Cache), vérifiez dans .htaccess la section contenant les règles de ce plugin, elle est généralement encadrée par des commentaires comme # BEGIN W3TC / # END W3TC. Supprimez ce bloc, enregistrez le fichier et rafraîchissez le site.

Étape 8. Contacter votre hébergeur

Si aucune des étapes précédentes n’a aidé, le problème est très probablement côté serveur. Contactez le support technique de votre hébergeur et fournissez le nom de domaine, l’heure d’apparition de l’erreur et les étapes que vous avez déjà effectuées. Plus vous donnez de détails, plus vite les ingénieurs trouveront la cause.

Demandez-leur de vérifier les journaux d’erreurs PHP et du serveur web pour la période où la 502 est apparue. Les journaux montrent presque toujours quel script ou module exact provoque la panne. Sur les hébergements mutualisés économiques, la cause peut simplement être un manque de ressources: un site sur le serveur consomme toute la mémoire et les autres reçoivent une 502. Dans ce cas, il est judicieux d’envisager de passer à un VPS ou un hébergement cloud avec des ressources garanties.

Guide vidéo

Regardez une démonstration visuelle du diagnostic et de la correction de l’erreur 502, de la première à la dernière étape, dans cette vidéo:

⁉️🤔 Foire aux questions

Une erreur 502 peut-elle se résoudre d’elle-même?

Oui, si la cause est une brève surcharge du serveur d’hébergement. Les fournisseurs surveillent la charge et redémarrent automatiquement les processus problématiques en une à cinq minutes. Rafraîchissez la page après quelques minutes; dans la moitié des cas, l’erreur disparaît sans aucune action de votre part.

Comment distinguer une 502 des autres erreurs serveur?

Une 502 Bad Gateway est une erreur au niveau du serveur proxy (Nginx/Apache), pas de l’application elle-même. Une 500 Internal Server Error indique un problème directement dans le code PHP ou la configuration. Une 503 Service Unavailable signifie que le serveur n’accepte temporairement pas de requêtes, généralement lors d’une maintenance planifiée. Une 504 Gateway Timeout signifie que le serveur n’a pas reçu de réponse du serveur amont dans le délai imparti. Pour l’utilisateur, la différence se résume au diagnostic: une 500 se corrige le plus souvent en modifiant le code, tandis qu’une 502 se corrige en rétablissant la communication entre les serveurs.

Dois-je restaurer le site à partir d’une sauvegarde pour une 502?

Une sauvegarde est un dernier recours, pas une première étape. Avant de déployer une sauvegarde, suivez les étapes 5, 6 et 7 de ce guide: désactivez les plugins, vérifiez le thème, réinitialisez .htaccess. Dans la grande majorité des cas, une 502 se résout sans restaurer de sauvegarde. Déployez une sauvegarde uniquement si l’erreur est apparue immédiatement après une mise à jour de WordPress, des plugins ou du thème et qu’il est impossible de revenir en arrière via FTP.

Puis-je éviter les erreurs 502 à l’avenir?

En partie, oui. Utilisez un hébergement de qualité avec suffisamment de mémoire PHP (le minimum recommandé est de 256 Mo). Mettez en place une surveillance de la disponibilité de votre site via UptimeRobot ou un service similaire; vous serez informé d’un problème avant que les visiteurs ne le signalent. Avant d’installer ou de mettre à jour des plugins, faites une sauvegarde rapide. Et gardez un accès FTP à portée de main: quand l’administration est hors service, c’est le seul moyen de désactiver rapidement un code problématique.

Que faire si rien n’a aidé?

Les huit étapes ci-dessus couvrent presque tous les scénarios de 502 Bad Gateway sur WordPress. Si vous avez vérifié les plugins, le thème, le DNS et le CDN, réinitialisé .htaccess et que l’erreur persiste, le problème est plus profond et vous ne pouvez pas vous passer des ingénieurs de l’hébergement.

La bonne séquence fait gagner des heures: écartez d’abord les causes locales (cache, navigateur, CDN), puis les causes côté serveur (plugins, thème, .htaccess) et seulement ensuite escaladez au fournisseur. Gardez ce guide dans vos favoris; une 502 a la fâcheuse habitude de revenir au pire moment et un accès rapide à cette liste de vérification vous épargnera beaucoup de stress.