Dépannage WordPress
Erreur 502 WordPress : retrouver la passerelle en défaut
Une erreur 502 signifie qu’une passerelle a reçu une réponse invalide ou aucune réponse exploitable de l’amont. Sur WordPress, CDN, reverse proxy, nginx/Apache et PHP-FPM peuvent chacun être la couche qui l’affiche.
Ce que ce symptôme signifie réellement
Contrairement à une erreur applicative classique, une 502 demande de corréler les journaux des deux côtés de la passerelle.
Une requête lente, un processus PHP tué, un socket indisponible ou une configuration d’amont erronée sont des familles différentes.
Avant toute modification : préserver les preuves et le retour arrière
Notez l’heure, l’URL, le message exact, le code HTTP et le dernier changement connu. Vérifiez ensuite qu’une sauvegarde récente couvre bien les fichiers et la base de données, qu’elle est lisible et qu’un retour arrière limité est possible. Une sauvegarde non testée ne suffit pas pour une intervention risquée.
- Ne transmettez jamais de mot de passe, clé privée, jeton, fichier
wp-config.phpou export de base dans un formulaire ou une capture. - Travaillez d’abord sur un staging ou une copie isolée lorsque le diagnostic exige une mise à jour, une modification de code ou une opération de base de données.
- Conservez les journaux et les fichiers suspects avant nettoyage : ils peuvent être nécessaires pour comprendre la cause ou vérifier l’étendue d’un incident.
Diagnostic : avancer du signal le plus fiable au test le moins intrusif
Relevez heure, URL, point de présence, en-têtes et résultat direct origine si cet essai est autorisé et protégé.
- Identifier la couche qui produit la page 502.
- Corréler accès proxy, erreur serveur et journal PHP à la seconde près.
- Contrôler disponibilité des workers, socket/port et délais.
- Comparer une URL statique, une page WordPress simple et l’URL lente.
Correction : appliquer une action ciblée et réversible
Réparez la connexion ou la charge confirmée ; augmenter tous les timeouts ne fait que déplacer le symptôme.
- Redémarrer un service uniquement avec état, impact et rollback connus.
- Corriger le socket, l’amont ou la configuration divergente.
- Optimiser la requête ou le hook qui bloque PHP.
- Ajuster workers et délais après mesure, sans surallouer la mémoire.
Contrôles après correction
Une page qui se recharge ne suffit pas à prouver que le problème est résolu. Contrôlez le parcours concerné, une page non connectée, l’administration, les erreurs console et réseau, les journaux serveur, le cache et les redirections. Vérifiez aussi les écrans mobile et desktop si le symptôme touchait le rendu.
- CDN et origine cohérents.
- Aucune nouvelle erreur amont.
- Temps de réponse et saturation mesurés après correction.
Quand arrêter et demander une intervention
Une 502 récurrente avec processus tués ou disque saturé nécessite une analyse VPS et capacité avant de toucher au thème.