WordPress erreur 502 Bad Gateway : le diagnostic qui marche

Cet article est une version condensée du guide complet publié sur WP Admin Lab.

Une erreur 502 Bad Gateway signifie que le serveur frontal (Nginx, proxy, CDN) a bien reçu la requête, mais que le backend PHP n'a pas répondu correctement. Contrairement à une erreur 500, le problème ne vient pas forcément de votre code : il se situe souvent dans la chaîne serveur.

Diagnostiquer en 5 minutes

Commencez par isoler le maillon fautif :

1. Testez la page avec un cache buster : curl -I "https://votresite.com/?nocache=1". Si la page passe, c'est le cache ou le CDN qui sert une vieille erreur.
2. Vérifiez si wp-admin répond. Un front en 502 avec un back office fonctionnel pointe vers le cache de page.
3. Consultez les logs serveur (error_log à la racine ou logs Nginx). Cherchez upstream timed out ou connect() failed.

Les causes les plus fréquentes

PHP-FPM saturé ou planté. C'est la cause numéro un. Un plugin gourmand, une boucle infinie ou un pic de trafic épuise les workers PHP. Sur un VPS : systemctl restart php8.2-fpm. En mutualisé, contactez l'hébergeur ou attendez le recyclage automatique des processus.

Timeout entre proxy et backend. Nginx coupe par défaut à 60 secondes. Une requête lourde (import, sauvegarde, cron) dépasse ce délai et déclenche le 502. Augmentez proxy_read_timeout et fastcgi_read_timeout si vous contrôlez la configuration.

CDN mal configuré. Cloudflare renvoie ses propres pages 502. Vérifiez le statut réel de l'origine en contournant le CDN (fichier hosts local pointant vers l'IP du serveur).

Limites mémoire PHP. Un memory_limit trop bas fait planter le worker en plein rendu. Passez à 256M et surveillez les logs.

Le réflexe WordPress

Si le 502 survient après une mise à jour de plugin, désactivez les extensions via FTP en renommant le dossier wp-content/plugins, puis réactivez-les une par une. La méthode complète pas à pas est détaillée dans notre diagnostic de l'erreur 500, dont la logique s'applique aussi au 502.

Un back office qui rame en permanence avant même le 502 est un signal d'alerte : notre guide sur le back office WordPress lent montre comment identifier les requêtes qui saturent PHP.

Prévenir plutôt que guérir

Surveillez votre site avant que les visiteurs ne voient l'erreur : un simple curl en cron toutes les 5 minutes avec alerte email suffit. Et faites un état des lieux régulier de la configuration serveur avec un scan WordPress gratuit qui contrôle les en-têtes, le TLS et la configuration exposée.

Le guide complet avec les commandes détaillées pour chaque hébergeur est disponible ici : WordPress erreur 502 : corriger Bad Gateway.