L’erreur 502 Bad Gateway signifie qu’un serveur placé entre vous et le site, comme un proxy, un CDN ou un répartiteur, a reçu une réponse invalide du serveur d’origine. Visiteur, actualisez puis réessayez plus tard. Propriétaire, vérifiez que PHP-FPM ou votre application tourne, puis les délais d’attente, Cloudflare et l’hébergeur.
Un site sérieux ne dialogue presque jamais directement avec votre navigateur. Une « passerelle » (nginx, Apache en proxy, Cloudflare, un répartiteur de charge) reçoit la demande et la transmet à un second serveur qui fabrique la page. Le message 502 apparaît quand ce second serveur ne répond pas, répond de travers ou s’arrête en cours de route.
Les causes fréquentes : un service PHP ou Node arrêté ou saturé, un script trop long, un pare-feu qui bloque la passerelle, une panne chez l’hébergeur. Les étapes 1 à 3 s’adressent à la personne qui visite un site, les étapes 4 à 8 à la personne qui le possède ou l’administre.
Actualiser la page et patienter
Si vous visitez un site. Rechargez avec F5 (ou Cmd + R sur Mac) après un petit moment. Une 502 disparaît souvent seule lorsque le service redémarre ou que la charge retombe. Évitez de multiplier les rechargements sur une page de paiement : vous risqueriez de déclencher plusieurs fois la même commande.
Tester un autre navigateur, un autre réseau
Si vous visitez un site. Ouvrez le site en navigation privée, puis depuis un autre réseau, par exemple la 4G ou la 5G de votre téléphone. Désactivez votre VPN le temps du test. Si le site s’affiche ailleurs, videz le cache du navigateur, puis le cache DNS de Windows en tapant ipconfig /flushdns dans l’invite de commandes. Si l’erreur est la même partout, elle vient du site.
Signaler la panne à l’éditeur
Si vous visitez un site. Vérifiez si d’autres personnes rencontrent la même panne : la page d’état de l’éditeur ou ses réseaux sociaux l’indiquent souvent. Sinon, écrivez-lui avec l’adresse de la page et l’heure de l’erreur. Vous n’avez rien d’autre à réparer.
Vérifier que le service PHP ou l’application fonctionne
Si c’est votre site. Sur un hébergement mutualisé, ouvrez l’espace client : repérez une panne annoncée, une limite de ressources atteinte ou un bouton pour redémarrer PHP. Sur un serveur dédié ou un VPS, contrôlez l’état du service (systemctl status php-fpm, dont le nom varie avec la version installée, ou celui de votre application Node) et relancez-le avec systemctl restart. Consultez ensuite le journal d’erreurs du serveur web, souvent /var/log/nginx/error.log : des mentions comme « upstream » ou « connect() failed » confirment que le service ne répondait pas.
Examiner les délais d’attente et la charge
Si c’est votre site. Un script qui dépasse la durée autorisée est coupé, et la passerelle renvoie alors une 502 ou une 504. Regardez si l’erreur survient sur une action précise : import, export, sauvegarde, génération de rapport. Augmentez prudemment max_execution_time côté PHP et, sur nginx, les délais comme fastcgi_read_timeout. Si le serveur manque de mémoire ou de processus, la vraie solution est d’alléger le site ou de changer d’offre d’hébergement, pas de rallonger les délais.
Contrôler Cloudflare ou le CDN
Si c’est votre site. Quand le site passe par Cloudflare, sa page d’erreur indique généralement quel maillon est en défaut : Cloudflare ou votre serveur d’origine. Dans le tableau de bord, cherchez l’option pour suspendre temporairement Cloudflare sur le domaine et testez l’adresse du serveur directement. Si le site marche sans Cloudflare, vérifiez que votre pare-feu ne bloque pas les adresses IP de Cloudflare et que l’enregistrement DNS pointe vers la bonne adresse d’origine. Les causes et réglages sont décrits dans la documentation Cloudflare citée plus bas.
Écarter un plugin, un thème ou un module défaillant
Si c’est votre site. Une extension qui consomme trop ou qui plante PHP produit une 502 sur la page concernée. Désactivez les extensions récemment ajoutées ou mises à jour, en renommant leur dossier par FTP si l’administration est inaccessible. La procédure complète figure dans le guide sur l’erreur 500 et dans celui de l’écran blanc WordPress.
Interroger l’hébergeur avec des éléments précis
Si c’est votre site. Si rien ne change, ouvrez un ticket chez l’hébergeur en joignant l’heure exacte des erreurs, l’adresse concernée et les lignes du journal. Demandez-lui s’il a constaté un redémarrage de PHP-FPM, une limite de processus ou de mémoire atteinte, ou une coupure du serveur. Des éléments datés accélèrent le diagnostic de son côté.
Questions fréquentes
Que signifie l’erreur 502 Bad Gateway ?
Elle signifie qu’un serveur intermédiaire (proxy, CDN, répartiteur de charge) a reçu une réponse invalide, ou aucune réponse, du serveur qui héberge réellement le site. Le problème ne vient pas de votre appareil. Il se règle côté serveur, par le propriétaire du site ou son hébergeur.
Quelle différence entre l’erreur 502 et l’erreur 504 ?
Dans les deux cas, une passerelle n’obtient pas ce qu’il faut du serveur d’origine. Avec la 502, la réponse reçue est invalide ou la connexion est refusée ; avec la 504, le serveur d’origine ne répond pas à temps. Les vérifications sont proches : service arrêté, délais, charge, pare-feu.
Comment corriger une erreur 502 sur nginx ?
Lisez d’abord le journal d’erreurs nginx, qui nomme la cause. Vérifiez ensuite que le service en aval (PHP-FPM, application Node) est lancé et que l’adresse ou le socket déclaré dans la configuration est le bon. Contrôlez enfin les délais d’attente et les droits sur le socket. Rechargez nginx après toute modification.
Une erreur 502 peut-elle venir d’un virus ou d’un piratage ?
C’est possible mais rare. Un site compromis peut saturer le serveur ou casser sa configuration et provoquer des 502. Si vous observez aussi des redirections étranges ou des fichiers inconnus, lisez le guide sur un site WordPress piraté avant de modifier quoi que ce soit.
Sources
Voir aussi
- Erreur 500 (Internal Server Error) : que faire, visiteur ou propriétaire ?
- Erreur 503 Service Unavailable : que faire, visiteur ou propriétaire ?
- Écran blanc de la mort WordPress : comment réparer un site qui n’affiche plus rien
- Site WordPress piraté ou redirigé vers un autre site : que faire, étape par étape