Erreur 502 : que signifie cette erreur et comment la corriger ?

L’erreur 502 est une erreur HTTP qui apparaît lorsqu’un serveur intermédiaire, comme un proxy, un reverse proxy, un CDN ou une passerelle, reçoit une réponse invalide du serveur situé en amont. Le message affiché est généralement « 502 Bad Gateway », que l’on peut traduire par « 502 Mauvaise Passerelle ». Dans la majorité des cas, le problème se situe donc quelque part entre les différents serveurs qui participent au traitement de votre requête.

Cette erreur peut être temporaire, mais elle peut aussi révéler un problème plus profond : serveur surchargé, service PHP-FPM arrêté, mauvaise configuration Nginx, problème DNS, connexion refusée entre deux serveurs, proxy mal configuré, problème avec un CDN ou encore application qui ne répond pas correctement.

Voyons précisément ce que signifie une erreur 502, pourquoi elle apparaît et surtout comment résoudre l’erreur 502 Bad Gateway selon la situation.

Erreur 502 : c’est quoi exactement ?

Pour comprendre l’erreur 502, il faut imaginer qu’une requête web peut traverser plusieurs intermédiaires avant d’atteindre l’application qui doit générer la page.

Par exemple :

Navigateur → CDN/proxy → serveur web → PHP-FPM → application → base de données

Lorsque vous demandez une page, le serveur intermédiaire transmet la requête au serveur situé en amont. Si celui-ci renvoie une réponse invalide, si la connexion échoue ou si le serveur intermédiaire ne reçoit pas une réponse exploitable, il peut retourner une erreur 502 Bad Gateway au navigateur. C’est précisément le comportement décrit par la spécification HTTP.

Le code 502 appartient à la famille des erreurs HTTP 5xx, qui correspondent aux problèmes rencontrés côté serveur.

Cela explique pourquoi une erreur 502 n’est généralement pas provoquée par une faute de frappe dans l’URL ou par une mauvaise utilisation du site.

Que signifie le code d’état HTTP 502 ?

Le code d’état HTTP 502 Bad Gateway signifie qu’un serveur qui joue le rôle de passerelle ou de proxy a reçu une réponse invalide du serveur en amont.

Le terme Gateway signifie « passerelle ». Quant à Bad, il indique que la réponse reçue n’est pas exploitable.

La traduction de 502 Bad Gateway est donc généralement « 502 Mauvaise Passerelle ».

Il est important de comprendre une nuance : le code 502 ne donne pas nécessairement la cause précise du problème. Il indique surtout à quel endroit de la chaîne de communication le problème a été constaté. Il faut ensuite consulter les journaux du serveur, vérifier les services concernés et examiner la configuration pour trouver l’origine réelle de la panne.

Pourquoi une erreur 502 apparaît-elle ?

Une erreur 502 peut avoir plusieurs origines. Le point commun est généralement un problème de communication entre un serveur intermédiaire et un serveur en amont.

Serveur en amont indisponible

C’est l’un des cas les plus classiques.

Un reverse proxy Nginx peut par exemple transmettre une requête à PHP-FPM. Si PHP-FPM est arrêté ou inaccessible, Nginx ne peut pas obtenir la réponse nécessaire et peut alors retourner une erreur 502.

La même logique s’applique lorsqu’un proxy doit communiquer avec une application située sur un autre serveur et que cette application n’est plus accessible. Nginx documente notamment les situations dans lesquelles une connexion vers un serveur en amont échoue et entraîne une réponse 502.

PHP-FPM arrêté ou défaillant

Sur de nombreux sites WordPress et applications PHP utilisant Nginx, PHP-FPM joue un rôle essentiel.

Si le service PHP-FPM est arrêté, saturé, plante pendant le traitement d’une requête ou utilise un socket inaccessible, Nginx peut être incapable d’obtenir une réponse valide.

Un message tel que connect() failed ou un problème lié au fichier php-fpm.sock dans les journaux peut alors orienter directement le diagnostic.

Serveur surchargé

Un pic brutal de trafic, une consommation excessive de mémoire ou un nombre trop important de processus peuvent empêcher un serveur de répondre correctement.

Une application peut également consommer trop de ressources CPU ou RAM et provoquer des interruptions de services.

Dans ce cas, le 502 peut être temporaire si la surcharge disparaît, mais une erreur récurrente nécessite une analyse des ressources disponibles et de la configuration du serveur.

Problème DNS

Une mauvaise configuration DNS peut également provoquer une erreur 502.

Le proxy ou le CDN doit pouvoir déterminer vers quelle adresse IP envoyer la requête. Si le domaine pointe vers un mauvais serveur, si une adresse IP vient d’être modifiée ou si la configuration DNS est incorrecte, la communication avec le serveur d’origine peut échouer.

Mauvaise configuration du proxy ou du reverse proxy

Une erreur dans la configuration de Nginx, d’un load balancer ou d’un CDN peut empêcher la passerelle de communiquer correctement avec le serveur d’origine.

Par exemple, une mauvaise adresse IP, un mauvais port, un mauvais socket PHP-FPM ou une règle de routage incorrecte peuvent suffire à provoquer un 502.

Pare-feu ou règle de sécurité

Un pare-feu peut également empêcher un serveur intermédiaire de communiquer avec le serveur d’origine.

Cela peut arriver lorsqu’une adresse IP est bloquée, lorsqu’un port nécessaire n’est pas accessible ou lorsqu’une règle de sécurité empêche le trafic légitime de parvenir au serveur en amont.

Application ou plugin défaillant

Sur WordPress, une extension ou un thème peut provoquer indirectement une erreur 502 lorsqu’il entraîne un plantage de PHP, une consommation excessive de ressources ou un traitement qui perturbe PHP-FPM.

Il ne faut donc pas systématiquement considérer le 502 comme un simple problème de Nginx : il faut identifier le composant situé derrière le proxy qui ne répond pas correctement.

Comment corriger l’erreur 502 ?

La meilleure méthode consiste à procéder progressivement, du diagnostic le plus simple aux vérifications serveur les plus techniques.

1. Rechargez la page

Commencez par actualiser la page.

Une erreur 502 peut être provoquée par une panne temporaire, une surcharge momentanée ou un redémarrage d’un service. Certains hébergeurs recommandent donc de patienter quelques instants avant de réessayer.

Si le site fonctionne après quelques minutes, le problème était probablement temporaire.

En revanche, si l’erreur revient systématiquement, il faut poursuivre le diagnostic.

2. Testez le site depuis un autre navigateur ou appareil

Essayez le site depuis un autre navigateur ou une autre connexion Internet.

Vous pouvez également vider le cache du navigateur.

Cette étape permet de déterminer si le problème est général ou lié à votre environnement local. Elle ne corrigera cependant pas un problème réellement situé sur le serveur.

3. Vérifiez si le site est inaccessible pour tout le monde

Si vous êtes le propriétaire du site, essayez de l’ouvrir depuis une autre connexion.

Vous pouvez par exemple utiliser un smartphone connecté au réseau mobile plutôt que votre connexion habituelle.

Si le 502 apparaît partout, le problème se trouve probablement au niveau du serveur, du proxy, du CDN ou de l’hébergement.

Comment résoudre l’erreur 502 sur WordPress ?

Lorsqu’une erreur 502 apparaît sur WordPress, il faut déterminer si elle vient de WordPress lui-même ou de l’infrastructure qui l’exécute.

Commencez par vérifier si l’erreur concerne tout le site ou seulement certaines pages.

Si seule une action précise provoque le 502, par exemple l’ouverture de l’administration, l’activation d’une extension ou l’exécution d’une fonctionnalité particulière, cela fournit déjà un indice important.

Un plugin ou un thème peut provoquer un plantage PHP ou une consommation excessive de ressources. Dans un environnement Nginx + PHP-FPM, un processus PHP qui s’arrête brutalement peut notamment conduire Nginx à retourner un 502.

Il faut alors examiner les journaux PHP, Nginx et WordPress avant de désactiver des éléments au hasard.

Si vous avez récemment installé ou mis à jour une extension, un thème, PHP ou une configuration serveur, cette modification constitue également une piste à examiner en priorité.

Erreur 502 Bad Gateway Nginx : que vérifier ?

L’erreur 502 Bad Gateway Nginx est particulièrement fréquente dans les architectures où Nginx fonctionne comme reverse proxy devant PHP-FPM ou une autre application.

Dans cette configuration, Nginx reçoit la requête puis la transmet au serveur applicatif.

La première chose à faire est donc de consulter le journal d’erreurs Nginx.

Selon le message rencontré, le diagnostic peut être très différent.

Par exemple :

• connect() failed peut indiquer que le serveur en amont n’est pas accessible ;
• no live upstreams peut indiquer qu’aucun serveur en amont disponible ne peut traiter la requête ;
• une erreur liée à php-fpm.sock peut révéler un problème de socket ou de service PHP-FPM ;
• upstream prematurely closed connection peut indiquer que le serveur en amont a fermé la connexion avant de fournir une réponse complète ;
• un message concernant des en-têtes trop volumineux peut orienter vers un problème de configuration des buffers.

Le journal d’erreurs est donc beaucoup plus utile que le simple message 502 Bad Gateway affiché dans le navigateur.

Vérifiez PHP-FPM

Si votre site utilise PHP avec Nginx, vérifiez que PHP-FPM fonctionne correctement.

Sur un serveur Linux, vous pouvez vérifier l’état du service avec la commande correspondant à votre version de PHP, par exemple :

systemctl status php8.3-fpm

Si le service est arrêté, son redémarrage peut rétablir immédiatement le fonctionnement du site :

sudo systemctl restart php8.3-fpm

La version exacte de PHP dépend naturellement de votre serveur.

Il faut également vérifier que Nginx utilise le bon socket ou le bon port PHP-FPM. Un mauvais chemin de socket peut provoquer un 502 même lorsque PHP est installé sur le serveur.

Consultez les logs avant de modifier la configuration

C’est probablement l’étape la plus importante lorsqu’un 502 persiste.

Ne commencez pas par augmenter tous les timeouts ou modifier plusieurs paramètres simultanément.

Cherchez d’abord la raison pour laquelle le serveur intermédiaire n’obtient pas une réponse exploitable.

Pour Nginx, consultez notamment le fichier error.log.

Pour PHP-FPM, recherchez les erreurs dans son propre journal.

Pour WordPress, le mode de débogage peut également être utile lorsque le problème vient de PHP ou d’une extension.

L’objectif est de répondre à une question simple :

Quel serveur ou quel service situé en amont ne répond pas correctement ?

Une fois cette information obtenue, le correctif devient beaucoup plus précis.

Erreur 502 Google : que signifie-t-elle ?

Vous pouvez également rencontrer une erreur 502 Google, parfois avec un message du type « 502. That’s an error » ou une variante indiquant une erreur temporaire.

Dans ce contexte, le code 502 conserve sa signification HTTP : un serveur jouant le rôle de passerelle ou de proxy n’a pas obtenu une réponse valide du serveur en amont.

Il ne faut donc pas interpréter automatiquement un 502 affiché par Google comme un problème provenant de votre ordinateur.

Comme pour les autres erreurs 502, il faut déterminer quel maillon de la chaîne de communication est à l’origine de l’échec.

Qu’est-ce qu’une erreur de proxy et comment la corriger ?

Une erreur de proxy apparaît lorsqu’un serveur intermédiaire chargé de transmettre une requête rencontre un problème avec le serveur auquel il doit communiquer cette requête.

Le proxy peut être un reverse proxy installé sur votre serveur, un CDN, un équilibreur de charge ou une autre infrastructure intermédiaire.

Pour corriger une erreur de proxy, il faut donc vérifier la communication entre le proxy et le serveur d’origine.

Les points à contrôler sont notamment :

Adresse du serveur en amont : le proxy doit pointer vers le bon serveur.

Port : le port utilisé doit être ouvert et correspondre au service attendu.

Service applicatif : PHP-FPM, Node.js, Apache ou une autre application doit fonctionner correctement.

Pare-feu : aucune règle ne doit bloquer inutilement la communication.

DNS : le domaine doit pointer vers l’infrastructure correcte.

Configuration du proxy : les règles Nginx, Apache, CDN ou load balancer doivent être cohérentes.

Erreur 502 et Cloudflare : où se situe le problème ?

Lorsque Cloudflare est utilisé devant un site, il devient un maillon supplémentaire dans la chaîne :

Visiteur → Cloudflare → serveur d’origine

Cloudflare indique que les erreurs 502/504 peuvent provenir soit du serveur d’origine, soit de l’infrastructure Cloudflare. Il faut donc commencer par déterminer quelle partie de la chaîne renvoie réellement l’erreur.

Si le serveur d’origine renvoie lui-même une erreur 502, Cloudflare peut simplement la transmettre au visiteur.

Dans ce cas, modifier les paramètres Cloudflare ne corrigera pas nécessairement le problème : il faut examiner le serveur d’origine.

Quelle différence entre erreur 500, 502, 503 et 504 ?

Ces quatre erreurs sont souvent confondues.

Erreur 500 — Internal Server Error : le serveur rencontre une erreur interne qu’il ne sait pas traiter correctement.

Erreur 502 — Bad Gateway : une passerelle ou un proxy reçoit une réponse invalide du serveur en amont.

Erreur 503 — Service Unavailable : le serveur n’est temporairement pas prêt à traiter la requête, par exemple en raison d’une maintenance ou d’une surcharge.

Erreur 504 — Gateway Timeout : la passerelle n’a pas reçu à temps une réponse du serveur en amont.

La différence entre 502 et 504 est particulièrement importante : avec un 502, la passerelle reçoit une réponse qu’elle considère comme invalide ou rencontre un échec de communication ; avec un 504, elle n’obtient pas de réponse dans le délai prévu.

502 Bad Gateway : que faire si vous êtes simplement visiteur ?

Si vous consultez un site qui affiche une erreur 502 et que vous n’en êtes pas le propriétaire, vous avez peu de possibilités d’action sur le serveur.

Commencez par actualiser la page après quelques instants.

Ensuite, essayez un autre navigateur ou une autre connexion Internet. Vous pouvez également vider le cache du navigateur.

Si le problème persiste alors que le site fonctionne normalement pour d’autres personnes, vérifiez votre connexion, votre VPN, votre proxy ou vos paramètres DNS. Ces configurations peuvent parfois perturber la communication avec certains services.

Si le site reste inaccessible pour tout le monde, le problème doit généralement être traité par son propriétaire, son développeur ou son hébergeur.

Comment diagnostiquer rapidement une erreur 502 ?

Si vous administrez le site, utilisez cette méthode :

1. Identifiez l’étendue du problème.
Tout le site est-il inaccessible ou une seule URL est-elle concernée ?

2. Vérifiez les dernières modifications.
Plugin, thème, mise à jour PHP, configuration Nginx, DNS, CDN ou migration récente ?

3. Consultez les logs.
Commencez par Nginx ou le serveur web, puis examinez PHP-FPM et l’application.

4. Vérifiez le serveur en amont.
PHP-FPM, Apache, Node.js ou l’application concernée fonctionne-t-il ?

5. Vérifiez les ressources.
CPU, RAM, processus, connexions et limites du serveur sont-ils suffisants ?

6. Vérifiez le réseau.
DNS, pare-feu, ports, proxy et CDN communiquent-ils correctement ?

7. Testez après chaque modification.
Évitez de modifier simultanément cinq paramètres : vous risqueriez de ne plus savoir ce qui a réellement corrigé le problème.

Cette approche est généralement beaucoup plus efficace que de chercher une « solution universelle » au 502, car le code 502 décrit le symptôme, pas nécessairement la cause.

Une erreur 502 est-elle grave pour un site web ?

Une erreur 502 temporaire n’implique pas nécessairement une panne durable.

En revanche, un 502 récurrent mérite une véritable investigation. Si les visiteurs rencontrent régulièrement cette erreur, le problème peut révéler une infrastructure insuffisamment dimensionnée, un service instable, une mauvaise configuration du serveur ou une application qui consomme trop de ressources.

Pour un site professionnel ou une boutique en ligne, il est particulièrement important de corriger la cause plutôt que de simplement faire disparaître temporairement le message d’erreur.

FAQ sur l’erreur 502

Que signifie l’erreur 502 ?

L’erreur 502 signifie qu’un serveur agissant comme passerelle ou proxy a reçu une réponse invalide du serveur en amont.

502 Bad Gateway, ça veut dire quoi ?

502 Bad Gateway signifie littéralement « mauvaise passerelle ». Le serveur intermédiaire n’a pas obtenu une réponse exploitable du serveur auquel il devait transmettre la requête.

Comment corriger l’erreur 502 ?

Commencez par actualiser la page et vérifier si le problème est temporaire. Si vous administrez le site, consultez ensuite les logs du serveur, vérifiez PHP-FPM ou l’application en amont, les ressources, le DNS, le pare-feu, le proxy et la configuration du serveur.

Pourquoi Nginx affiche-t-il une erreur 502 ?

Nginx peut afficher un 502 lorsqu’il ne parvient pas à obtenir une réponse valide de son serveur en amont, par exemple PHP-FPM ou une application accessible via proxy_pass ou fastcgi_pass.

Quelle est la différence entre 502 et 504 ?

Le 502 indique que la passerelle a rencontré une réponse invalide ou un échec de communication avec l’amont. Le 504 indique que la passerelle n’a pas reçu de réponse à temps.

L’erreur 502 vient-elle forcément de mon ordinateur ?

Non. Elle provient généralement de la communication entre un serveur intermédiaire et un serveur en amont. Des problèmes locaux de réseau, de proxy, de VPN ou de DNS peuvent toutefois provoquer certains cas particuliers.

Conclusion

L’erreur 502 n’est pas une erreur mystérieuse : elle indique généralement qu’un intermédiaire — proxy, reverse proxy, CDN ou passerelle — n’a pas obtenu une réponse valide du serveur situé en amont.

Pour un simple visiteur, actualiser la page, vider le cache ou tester une autre connexion peut suffire lorsque le problème est temporaire. Pour le propriétaire d’un site, le diagnostic doit aller plus loin : logs Nginx, PHP-FPM, serveur web, DNS, pare-feu, ressources, proxy et application doivent être examinés méthodiquement.

Sur WordPress, une erreur 502 persistante peut notamment nécessiter l’analyse de PHP-FPM, du serveur Nginx, d’une extension, du thème ou de la configuration de l’hébergement.

Si votre site affiche régulièrement une erreur 502 et que vous ne parvenez pas à identifier la cause, je peux intervenir pour diagnostiquer le problème et rétablir le fonctionnement du site.

Découvrir mes services de développement web