Erreur 502 Bad Gateway : signification et solutions
Erreur 502 Bad Gateway : un serveur a reçu une réponse invalide du serveur derrière lui. Que faire côté visiteur ou côté serveur (nginx, PHP-FPM, Cloudflare).
L’erreur 502 Bad Gateway signifie qu’un serveur jouant le rôle de passerelle ou de proxy a reçu une réponse invalide du serveur placé derrière lui. Le problème se situe entre deux serveurs : il ne vient donc ni du navigateur ni de l’appareil du visiteur. [1] [2]
Ce guide comporte deux parties. Si vous êtes un visiteur, la courte section ci-dessous indique ce que vous pouvez essayer. Si vous gérez le site, la partie consacrée à la correction vous montre comment trouver le maillon qui a renvoyé l’erreur 502, lire la ligne de journal qui en donne la cause, puis corriger le problème et éviter qu’il ne se reproduise.
Que signifie l’erreur 502 Bad Gateway ?
Une requête vers un site web passe souvent par plusieurs maillons, du navigateur jusqu’à l’application :
browser → CDN or proxy → web server → application
Chaque maillon transmet la requête au suivant. Si le maillon situé derrière un proxy lui fournit une réponse inexploitable, le proxy renvoie une erreur 502. Le code d’état n’indique pas quel maillon a échoué. Avec nginx, une erreur 502 apparaît aussi quand le serveur amont (upstream) refuse la connexion, la réinitialise ou la ferme prématurément : le code vous apprend seulement que la liaison s’est rompue derrière le proxy.
Précisons ce qu’une erreur 502 n’est pas. D’abord, elle ne signale pas que le visiteur a envoyé une requête incorrecte. Ensuite, ce n’est pas un dépassement de délai : un serveur amont trop lent produit un autre code, présenté dans la section suivante.
Erreur 502, 503 ou 504 : quelle différence ?
Trois codes couvrent la plupart des défaillances côté serveur entre deux maillons. Ils renvoient à des causes différentes : lisez donc bien le code avant de commencer à chercher.
| Code | Ce qui s’est passé | Cause typique | À vérifier en premier |
|---|---|---|---|
| 502 Bad Gateway | La passerelle a reçu une réponse invalide du serveur amont [1] [2] | L’application est arrêtée ou a refusé la connexion, a planté en pleine requête, ou a envoyé des en-têtes que nginx ne peut pas accepter | La ligne du journal d’erreurs de nginx qui correspond à la requête |
| 503 Service Unavailable | Le serveur est temporairement incapable de traiter la requête [1] | Surcharge ou maintenance planifiée | La charge du serveur et l’éventuelle intervention en cours |
| 504 Gateway Timeout | La passerelle n’a pas reçu à temps la réponse du serveur amont [1] [3] | Le serveur amont est trop lent, par exemple à cause d’une longue requête en base de données, et le délai d’attente du proxy a expiré [4] | Quelle requête est lente, et ce que fait l’application pendant l’attente |
Une erreur 504 est un problème de délai : la réponse du serveur amont est arrivée trop tard, mais elle n’était pas incorrecte. Dans nginx, les délais de lecture par défaut du proxy et de FastCGI sont de 60 secondes [4] [5].
Augmenter un délai d’attente ne corrige pas une erreur 502
Les délais d’attente tels que proxy_read_timeout et fastcgi_read_timeout déterminent seulement combien de temps nginx attend une réponse. Une erreur 502 signifie que la réponse était défectueuse, manquante, ou qu’elle n’est jamais arrivée. Augmenter le délai n’y changera rien. Ne touchez aux délais d’attente que si l’erreur est une 504.
Si vous rencontrez une erreur 502 en tant que visiteur
Vous ne pouvez pas réparer le serveur, mais vous pouvez écarter un problème de votre côté et signaler l’erreur.
- Attendez une minute et rechargez la page. L’erreur peut disparaître d’elle-même à la fin d’un redémarrage ou d’un déploiement sur le serveur.
- Essayez un autre navigateur ou un autre réseau, par exemple les données mobiles. Si le site s’y affiche, le problème est propre à votre connexion.
- Consultez la page de statut du site, s’il en a une.
- Notez l’heure et l’adresse exacte de la page ouverte : le propriétaire du site en a besoin pour retrouver la ligne de journal correspondante.
La correction se fait généralement sur le serveur : seul le propriétaire du site peut donc faire disparaître l’erreur. Si le site est le vôtre, suivez les étapes ci-dessous.
Corriger une erreur 502 Bad Gateway sur votre serveur
Procédez de l’extérieur vers l’intérieur : à chaque étape, vous écartez un maillon avant de passer au suivant.
1. Trouver le serveur qui a renvoyé l’erreur 502
Envoyez deux requêtes pour la même page. La première emprunte le chemin public. La seconde se connecte directement à l’adresse IP de votre serveur d’origine et envoie le nom du site dans l’en-tête Host. Remplacez l’adresse d’exemple par la vôtre.
curl -I "https://www.example.com/"
curl -I --resolve www.example.com:443:203.0.113.10 "https://www.example.com/"Lisez la ligne d’état et les en-têtes de chaque réponse :
- Un en-tête
cf-rayetserver: cloudflareindiquent que la réponse est passée par Cloudflare. Ils apparaissent même lorsque l’erreur 502 vient de votre serveur d’origine et ne permettent donc pas de savoir quel côté a échoué : c’est la page elle-même qui vous le dira (voir la section sur Cloudflare plus bas). - Un en-tête
server: nginxsur la requête directe signifie que c’est le nginx de votre serveur d’origine qui a produit l’erreur 502.
Si la requête directe renvoie elle aussi une erreur 502, le problème vient du serveur d’origine : passez à l’étape 2. Si la requête directe renvoie 200 alors que la requête publique renvoie 502, la défaillance se situe sur le chemin entre le visiteur et le serveur d’origine. Lisez alors la page d’erreur elle-même, comme l’explique la section sur Cloudflare plus bas, et reportez-vous à l’étape 7.
2. Lire le journal d’erreurs
Quand nginx ne parvient pas à obtenir une réponse exploitable du serveur amont, il en consigne la raison dans son journal d’erreurs. Lisez les lignes les plus récentes :
sudo tail -n 50 /var/log/nginx/error.logRetrouvez la cause à partir du message :
| Ligne de journal (contient) | Cause habituelle | Que faire |
|---|---|---|
connect() failed (111: Connection refused) while connecting to upstream |
L’application ne tourne pas, ou elle écoute sur un autre port | Démarrez l’application ou corrigez le port (étape 3) |
connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory) |
Mauvais chemin de socket, ou PHP-FPM est arrêté | Vérifiez le chemin du socket et le service (étapes 3 et 4) |
connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied) |
Le propriétaire ou les droits du socket ne permettent pas à nginx de s’y connecter | Vérifiez les paramètres listen.owner, listen.group et listen.mode du pool PHP-FPM |
upstream prematurely closed connection while reading response header from upstream |
L’application a planté ou a été tuée pendant la requête, souvent par manque de mémoire | Vérifiez la mémoire et les journaux de plantage (étape 5) |
upstream sent too big header while reading response header from upstream |
Les en-têtes de la réponse dépassent la taille du tampon de nginx | Augmentez la taille du tampon (étape 6) |
no live upstreams while connecting to upstream |
Tous les serveurs du bloc upstream sont marqués comme défaillants | Vérifiez les serveurs du bloc, puis l’application derrière chacun d’eux (étape 3) |
La ligne indique l’adresse ou le socket du serveur amont. Comparez-la avec l’adresse ou le socket sur lequel l’application écoute réellement.
3. Vérifier que l’application tourne
Vérifiez le service ainsi que le port ou le socket sur lequel il écoute. Choisissez l’onglet qui correspond à votre pile logicielle.
sudo systemctl status php8.3-fpm
sudo ss -lxp | grep phppm2 status
sudo ss -ltnp | grep 3000sudo systemctl status gunicorn
sudo ss -ltnp | grep 8000Si vous faites tourner Node avec systemd, utilisez systemctl status <service> à la place de pm2 status. Si le service est arrêté, lisez ses journaux avant de le redémarrer pour ne pas perdre la cause du plantage, par exemple avec sudo journalctl -u php8.3-fpm -n 100.
4. Vérifier que proxy_pass ou fastcgi_pass correspond à l’application
L’adresse configurée dans nginx doit correspondre au port ou au socket relevé à l’étape 3. Sinon, vous obtenez les lignes « Connection refused » ou « No such file or directory » vues à l’étape 2.
Pour un reverse proxy vers une application qui écoute sur un port local :
location / {
proxy_pass http://127.0.0.1:3000;
}Pour PHP-FPM via un socket Unix :
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}Testez la configuration, puis rechargez nginx. Si le test échoue, le rechargement n’a pas lieu : nginx conserve alors la configuration qui fonctionne déjà.
sudo nginx -t && sudo systemctl reload nginx5. Vérifier la mémoire et les plantages
La ligne upstream prematurely closed connection signale un processus mort en pleine requête. Sur un petit VPS, la cause habituelle est l’OOM killer du noyau, qui tue des processus quand la mémoire est épuisée. Cherchez dans le journal du noyau :
sudo dmesg -T | grep -i -E "out of memory|killed process"
free -hPour PHP-FPM, cherchez server reached pm.max_children setting dans le journal d’erreurs de PHP-FPM. Ce message signifie que tous les processus enfants sont occupés. Chaque processus consomme de la RAM : n’augmentez donc pm.max_children qu’après avoir vérifié que le serveur dispose d’assez de mémoire libre pour ces processus supplémentaires [6].
Si la mémoire est tout simplement insuffisante pour le site, la solution est une offre supérieure, pas un délai d’attente plus long. Notre article sur les goulots d’étranglement courants des VPS montre comment une mémoire saturée se traduit par des ralentissements.
6. Corriger les erreurs 502 dues à la taille des en-têtes
Si le journal indique upstream sent too big header, les en-têtes de réponse du serveur amont dépassent la taille du tampon de nginx. Augmentez le tampon dans le bloc location concerné. Les valeurs ci-dessous sont des exemples : adaptez-les à votre plus gros en-tête.
location / {
proxy_pass http://127.0.0.1:3000;
proxy_buffer_size 16k;
proxy_buffers 8 16k;
}Pour PHP-FPM, utilisez de la même façon fastcgi_buffer_size et fastcgi_buffers dans le bloc location qui contient fastcgi_pass [5]. Vérifiez les valeurs par défaut de ces directives et leur syntaxe exacte dans la documentation de référence du module [4]. Vous pouvez aussi réduire la taille des en-têtes envoyés par l’application, par exemple des cookies trop volumineux. Testez ensuite la configuration et rechargez nginx comme à l’étape 4.
7. Vérifier le pare-feu entre le proxy et le serveur d’origine
Si un proxy se trouve sur une autre machine, ou si un service comme Cloudflare se connecte à votre serveur d’origine, une règle de pare-feu peut bloquer cette connexion. Le proxy n’obtient alors aucune réponse exploitable et renvoie une erreur 502. Vérifiez que le serveur d’origine accepte les connexions provenant des adresses du proxy sur le port qu’il utilise. Sous Ubuntu avec ufw :
sudo ufw status verboseSi vous utilisez un autre pare-feu, vérifiez plutôt ses règles.
Erreur 502 derrière Cloudflare
Le contenu de la page indique quel côté a produit l’erreur. D’après Cloudflare, une page 502 ou 504 aux couleurs de Cloudflare provient de votre serveur web d’origine. Une page brute, sans cet habillage, peut venir de Cloudflare lui-même, mais sa documentation cite aussi un problème de compression sur le serveur d’origine parmi les causes de ces erreurs 502 sans habillage [7]. L’habillage permet donc de trancher dans la plupart des cas, mais pas dans tous. Si la page n’a pas l’habillage de Cloudflare et que le serveur d’origine répond directement avec un code 200, vérifiez ses paramètres de compression.
Une erreur 502 nuit-elle au référencement ?
Une erreur 502 de courte durée fait peu de dégâts. D’après la documentation de Google consacrée à ses robots d’exploration, les réponses 5xx et 429 poussent ces robots à ralentir. Les URL qui continuent de renvoyer des erreurs serveur finissent par être retirées de l’index, même si les URL déjà indexées sont d’abord conservées. L’exploration accélère de nouveau une fois que le serveur renvoie des réponses 2xx [8].
En pratique, corrigez la cause rapidement : une erreur qui se répète pendant longtemps peut vous coûter des positions dans les résultats de recherche.
Prévenir les erreurs 502
- Surveillez le site depuis l’extérieur. Une sonde externe vous prévient dès que l’erreur 502 apparaît, sans attendre qu’un visiteur vous la signale. Voir notre article sur les outils de surveillance de la disponibilité.
- Prévoyez assez de RAM. Les processus tués par manque de mémoire sont à l’origine des lignes « prematurely closed connection ». Si le serveur manque régulièrement de mémoire, lisez nos articles sur les signes qu’il faut augmenter les ressources de votre VPS et sur les problèmes courants d’hébergement VPS et leurs solutions.
- Faites redémarrer l’application en cas de plantage. Une unité systemd dotée d’une politique de redémarrage relance l’application après un plantage.
Restart=on-failurene redémarre le processus que s’il se termine avec une erreur. Cela ne corrige pas le bug à l’origine du plantage : conservez donc les lignes de journal de l’étape 2.
[Service]
ExecStart=/usr/bin/node /srv/myapp/server.js
Restart=on-failure
RestartSec=5- Ajoutez un contrôle d’état (health check). Prévoyez dans l’application une URL qui ne renvoie 200 que si l’application est capable de traiter les requêtes, et surveillez cette URL. Un processus qui tourne mais reste bloqué apparaîtra alors comme une panne.
- Sachez où chercher quand le serveur s’arrête. Si le serveur cesse de répondre de lui-même, consultez pourquoi un serveur s’arrête de façon aléatoire.
Anticipez la prochaine panne
N’attendez pas un incident pour noter le port ou le socket d’écoute de l’application, le chemin de ses journaux et la commande de redémarrage. La correction de l’étape 2 dépend de la ligne de journal exacte, et pour un rétablissement rapide, il faut connaître le nom du service.
Appliquer ces corrections vous-même sur un VPS StealthRDP
Les offres Linux de StealthRDP incluent un accès root complet : vous gérez vous-même le serveur web et l’application, et vous pouvez suivre chaque étape de ce guide sur votre propre serveur. Pour comparer les offres, consultez les pages VPS Linux et Offres VPS.
Sources et références
- RFC 9110: HTTP Semantics — RFC Editor (IETF) (consulté le 2026-10-10)
- 502 Bad Gateway — MDN Web Docs (Mozilla) (consulté le 2026-10-10)
- 504 Gateway Timeout — MDN Web Docs (Mozilla) (consulté le 2026-10-10)
- Module ngx_http_proxy_module — nginx (consulté le 2026-10-10)
- Module ngx_http_fastcgi_module — nginx (consulté le 2026-10-10)
- PHP: Configuration (FPM) — The PHP Group (consulté le 2026-10-10)
- Error 502 or 504 — Cloudflare (consulté le 2026-10-10)
- How HTTP Status Codes Affect Google's Crawlers — Google (consulté le 2026-10-10)
À lire aussi
Protection DDoS pour VPS : ce qu’il faut vérifier et configurer
Comment évaluer un VPS avec protection DDoS et bâtir votre propre défense en plusieurs couches : pare-feu, filtrage, surveillance et reprise après incident.
VPS Windows ou Linux : lequel choisir pour votre entreprise ?
VPS Windows ou Linux ? Licences, ressources, logiciels, administration et sécurité : notre comparatif, avec un test rapide pour choisir selon votre usage.
8 signes qu’il est temps d’augmenter les ressources de votre VPS
Découvrez les signes qui montrent qu’il faut augmenter les ressources de votre VPS, des pages lentes au serveur saturé, pour garder un site performant.
