Votre site passe par un serveur relais (nginx, un proxy ou un service comme Cloudflare) qui transmet chaque demande au programme chargé de fabriquer les pages. Le code 502 signifie que ce relais a reçu une réponse vide ou illisible. Dans la plupart des cas, PHP s’est arrêté, a planté ou était saturé à ce moment-là.
Pourquoi cette erreur apparaît
- Les processus PHP (PHP-FPM) sont saturés ou se sont arrêtés, lors d’un pic de visites ou d’une tâche lourde.
- Une extension ou un module PHP fait planter le processus avant qu’il ait pu répondre.
- Le CDN ou le pare-feu placé devant le site, comme Cloudflare, n’arrive pas à joindre correctement votre serveur.
- Le serveur redémarre ou bascule vers une autre version de PHP après une intervention dans l’espace d’hébergement.
- La réponse de PHP contient des en-têtes trop volumineux pour la configuration de nginx.
Comment corriger le problème
Recharger et consulter l’état de l’hébergeur
Une erreur 502 est parfois passagère. Attendez un peu, rechargez la page et testez depuis un autre réseau. Jetez aussi un œil à la page d’état ou d’incidents de votre hébergeur : une panne de leur côté produit exactement ce message.
Repérer qui affiche la page d’erreur
Regardez le bas de la page : « nginx », « Apache » ou le logo de Cloudflare. La page de Cloudflare précise même si la panne se situe chez elle ou sur l’hébergement (mention Host Error). Dans ce second cas, c’est votre serveur qui ne répond pas correctement.
Écarter une extension trop gourmande
Si l’erreur survient sur une action précise (import, sauvegarde, génération de miniatures), désactivez l’extension qui s’en charge. Si l’administration ne répond plus, changez le nom du dossier de cette extension (dans wp-content/plugins) depuis votre logiciel FTP, puis rechargez le site.
Revenir à la version de PHP précédente
Dans l’espace d’hébergement, vérifiez la version de PHP choisie ; certains panneaux permettent aussi de relancer PHP. Revenir à la version utilisée avant l’incident indique vite si ce changement est en cause.
Lire les journaux de nginx et de PHP-FPM
Sur un VPS, le journal de nginx nomme la cause : « upstream prematurely closed connection » désigne un processus PHP qui a planté, « upstream sent too big header » des tampons trop petits, à relever avec fastcgi_buffer_size et fastcgi_buffers. Vérifiez aussi que le service PHP-FPM tourne bien.
sudo tail -n 50 /var/log/nginx/error.log
sudo systemctl status php8.3-fpmNotez chaque réglage que vous modifiez (version de PHP, configuration nginx) pour pouvoir revenir en arrière, et faites une sauvegarde avant de désactiver des extensions.
Un autre message d'erreur ? Collez-le dans le décodeur : il le reconnaît et vous oriente vers la bonne fiche.
Ouvrir le décodeur