Comment réparer une erreur 502 Bad Gateway sur votre site WordPress

En ce qui concerne WordPress, il existe de nombreuses erreurs différentes qui peuvent être carrément frustrantes et déroutantes. Quelques-uns qui me viennent à l'esprit sont l'écran blanc de la mort ou l'erreur effrayante lors de l'établissement d'une connexion à une base de données. Mais une erreur encore plus populaire est l'erreur 502 bad gateway. Pourquoi? Parce que cela se produit régulièrement sur l'ensemble du Web, non seulement sur les sites WordPress, mais même sur les services populaires tels que Gmail, Twitter et Cloudflare. Mais bien sûr, nous ne nous soucions vraiment que de son impact sur votre site WordPress. En savoir plus ci-dessous sur les causes de cette erreur et quelques solutions pour la résoudre rapidement.

• Qu'est-ce qu'une erreur 502 Bad Gateway ?
• Comment réparer l'erreur 502 Bad Gateway

Qu'est-ce qu'une erreur 502 Bad Gateway ?

L'erreur 502 Bad Gateway signifie spécifiquement que le serveur a reçu une réponse non valide d'un serveur entrant.

L'Internet Engineering Task Force (IETF) définit l'erreur 502 Bad Gateway comme suit :

Le code d'état 502 (Bad Gateway) indique que le serveur, tout en agissant en tant que passerelle ou proxy, a reçu une réponse non valide d'un serveur entrant auquel il a accédé en tentant de répondre à la demande.

Chaque fois que vous visitez un site Web, votre navigateur envoie une requête à un serveur Web. Le serveur Web reçoit et traite la demande, puis renvoie les ressources demandées avec un en-tête HTTP et un code d'état HTTP. En règle générale, un code d'état HTTP n'est pas visible à moins que quelque chose ne se passe mal. C'est essentiellement la façon dont les serveurs vous informent que quelque chose ne va pas, ainsi que le code sur la façon de le diagnostiquer.

Il existe de nombreux types différents de codes d'erreur d'état 500 (500, 501, 502, 503, 504, 508, 520, etc.) qui ont tous des significations légèrement différentes. Ceux-ci indiquent que la demande a été acceptée, mais que le serveur a empêché l'exécution de la demande.

Découvrez notre guide vidéo sur l'erreur 502

502 Variations d'erreur de passerelle incorrecte

En raison des différents navigateurs, serveurs Web et systèmes d'exploitation, une erreur de passerelle 502 incorrecte peut se présenter de différentes manières. Mais ils ont tous le même sens. Vous trouverez ci-dessous quelques-unes des nombreuses variantes que vous pourriez voir sur le Web :

• "502 Mauvaise passerelle"
• "Erreur 502"
• "Erreur HTTP 502 - Mauvaise passerelle"
• "Service 502 temporairement surchargé"
• "Erreur proxy 502"
• Un écran blanc vierge
• "502 Server Error: Le serveur a rencontré une erreur temporaire et n'a pas pu terminer votre demande"
• "HTTP 502"
• Erreur temporaire (502)
• 502. C'est une erreur
• 502 mauvaise passerelle Cloudflare
• Bad Gateway : le serveur proxy a reçu une réponse non valide d'un serveur en amont

Une autre variante que vous pourriez voir est une "erreur de serveur 502".

Et voici encore une autre variante. "502 - Le serveur Web a reçu une réponse non valide alors qu'il agissait en tant que passerelle ou serveur proxy. Il y a un problème avec la page que vous recherchez et elle ne peut pas être affichée. Lorsque le serveur Web (tout en agissant en tant que passerelle ou proxy) a contacté le serveur de contenu en amont, il a reçu une réponse non valide du serveur de contenu. »

D'autres services tels que Twitter peuvent même afficher un message complètement différent pour une erreur 502 Bad Gateway, comme "Twitter est en surcapacité". Cela semble certainement un peu plus convivial.

Et voici un aperçu de la façon dont Google l'affiche. "502. C'est une erreur. Le serveur a rencontré une erreur temporaire et n'a pas pu terminer votre demande. Veuillez réessayer dans 30 secondes. C'est tout ce que nous savons."

Impact des erreurs 502 sur le référencement

Contrairement aux erreurs 503, qui sont utilisées pour le mode de maintenance de WordPress et indiquent à Google de vérifier ultérieurement, une erreur 502 peut avoir un impact négatif sur le référencement si elle n'est pas corrigée immédiatement. Si votre site n'est en panne que pendant 10 minutes et qu'il est exploré de manière constante de nombreuses fois, le robot obtiendra simplement la page livrée à partir du cache. Ou Google pourrait même ne pas avoir la possibilité de le réexplorer avant qu'il ne soit sauvegardé. Dans ce scénario, tout va bien.

Cependant, si le site est indisponible pendant une période prolongée, disons plus de 6 heures, Google peut considérer l'erreur 502 comme un problème au niveau du site qui doit être résolu. Cela pourrait avoir un impact sur votre classement . Si vous craignez la répétition d'erreurs 502, vous devez d'abord comprendre pourquoi elles se produisent. Certaines des solutions ci-dessous peuvent vous aider.

Comment réparer l'erreur 502 Bad Gateway

Une erreur de passerelle 502 incorrecte est généralement un problème avec le réseau/serveur, cependant, il peut également s'agir d'un problème côté client. Nous allons donc plonger dans un peu des deux. Découvrez ces causes courantes et les moyens de corriger l'erreur 502 de la mauvaise passerelle et de vous remettre en marche.

1. Essayez de recharger la page

L'une des premières choses les plus simples que vous devriez essayer lorsque vous rencontrez une erreur de passerelle 502 incorrecte consiste simplement à attendre environ une minute et à recharger la page (F5 ou Ctrl + F5). Il se peut que l'hôte ou le serveur soit simplement surchargé et que le site revienne tout de suite. Pendant que vous attendez, vous pouvez également essayer rapidement un autre navigateur pour éliminer ce problème.

Une autre chose que vous pouvez faire est de coller le site Web dans downforeveryoneorjustme.com. Ce site Web vous indiquera si le site est en panne ou s'il s'agit d'un problème de votre côté.

2. Videz le cache de votre navigateur

Chaque fois que vous rencontrez des problèmes comme ceux-ci, il peut être bon de vider le cache de votre navigateur. Vous trouverez ci-dessous des instructions sur la façon de le faire dans les différents navigateurs :

• Comment forcer l'actualisation d'une seule page pour tous les navigateurs
• Comment effacer le cache du navigateur pour Google Chrome
• Comment effacer le cache du navigateur pour Mozilla Firefox
• Comment effacer le cache du navigateur pour Safari
• Comment vider le cache du navigateur pour Internet Explorer
• Comment effacer le cache du navigateur pour Microsoft Edge
• Comment effacer le cache du navigateur pour Opera

3. Problème DNS

Une erreur de passerelle 502 peut également être due à un problème DNS, tel que le domaine ne résout pas la bonne adresse IP ou le serveur DNS ne répond pas. Si vous venez de migrer votre site WordPress vers un nouvel hébergeur, est-il important d'attendre que les choses se propagent complètement, ce qui peut prendre jusqu'à 24 heures dans certains cas. Cela dépend de la valeur TTL de vos enregistrements DNS.

Vous pouvez également essayer de vider votre cache DNS local. Cela revient à vider le cache de votre navigateur.

Sous Windows, ouvrez simplement l'invite de commande et entrez ce qui suit :

 ipconfig /flushdns 

Vous devriez voir un "Vidage réussi du cache du résolveur DNS" si cela a fonctionné.

Pour les utilisateurs de macOS, vous pouvez saisir ce qui suit dans le terminal :

 dscacheutil -flushcache

Remarque : Il n'y a pas de message de réussite sur les Mac.

Et enfin, vous pouvez modifier temporairement vos serveurs DNS. Par défaut, les serveurs DNS sont automatiquement attribués par votre FAI. Mais vous pouvez essayer de les remplacer temporairement par un serveur DNS public, tel que Google. En fait, certains préfèrent utiliser le DNS public de Google à long terme. Si vous avez un DNS premium, la propagation est généralement beaucoup plus rapide.

4. Vérifiez auprès de votre hôte

La principale raison pour laquelle nous voyons généralement une erreur de passerelle incorrecte 502 est due à un problème avec l'hébergeur Web. Parfois, une requête, un script ou une demande prend trop de temps et est donc annulé ou tué par le serveur. De nombreux hôtes, en particulier les hôtes partagés, implémentent ce qu'ils appellent un "script de mise à mort". Fondamentalement, ce que cela fait, c'est qu'il mettra fin à une demande après une certaine période de temps afin qu'elle ne supprime pas un site ou n'affecte pas les autres utilisateurs. Si vous effectuez une recherche sur Twitter pour "mauvaise passerelle", vous pouvez voir des milliers de tweets se produire chaque jour alertant leur société d'hébergement du problème.

Une des raisons pour lesquelles vous pourriez envisager de passer à un hébergeur comme Kinsta est que notre plateforme fonctionne dans un conteneur logiciel isolé qui contient toutes les ressources logicielles nécessaires pour faire fonctionner le site (Linux, NGINX, PHP, MySQL). Cela signifie que le logiciel qui gère chaque site est 100% privé et n'est pas partagé , même entre vos propres sites. Cela réduit considérablement le risque de voir une erreur de passerelle 502 incorrecte. Nous n'exécutons pas de scripts de mise à mort agressifs comme le font certains hôtes partagés. Et même si l'un de vos sites tombe en panne, cela n'aura aucun impact sur vos autres sites.

Une autre raison pour laquelle vous pourriez voir une erreur de passerelle 502 avec votre hôte est également due au fait que le serveur n'est tout simplement pas accessible, soit parce qu'il est en panne, soit parce qu'il n'y a pas de connectivité. Dans ce cas, il est recommandé de vérifier la page de statut de votre hébergeur WordPress ou d'ouvrir un ticket d'assistance.

5. Désactiver temporairement le CDN ou le pare-feu

Il peut également s'agir d'un problème lié à votre réseau de diffusion de contenu (CDN) ou à votre pare-feu. Si vous utilisez un fournisseur de CDN tiers, un moyen simple de résoudre ce problème consiste simplement à désactiver temporairement votre CDN. Par exemple, nous sommes de grands fans du plugin gratuit d'activation CDN. Si vous l'utilisez, vous pouvez simplement désactiver le plugin, puis tester votre site. Wp-admin ne fonctionne pas ? Connectez-vous simplement à votre site via SFTP et renommez le dossier du plugin en cdn-enabler_old. Cela désactivera temporairement la connexion CDN. Il en va de même pour WP Rocket ou tout autre plugin que vous auriez pu connecter à votre CDN.

Cela peut également se produire parfois avec des fournisseurs qui fournissent une protection et une atténuation DDoS ou des services entièrement proxy comme Cloudflare, car ils ont des pare-feu supplémentaires entre les deux. Nous avons remarqué que cela se produit de temps en temps sur le plan gratuit Cloudflare. Malheureusement, comme Cloudflare est un service entièrement proxy, il n'existe aucun moyen rapide de le désactiver simplement.

Cependant, avant de blâmer Cloudflare, il est important de savoir qu'il existe deux types différents de 502 variations d'erreurs de mauvaise passerelle avec Cloudflare, comme indiqué ci-dessous :

502 Mauvaise passerelle chez Cloudflare (variante 1)

Si vous voyez l'écran suivant, il s'agit en fait d'un problème du côté de Cloudflare, auquel cas vous devez les contacter pour obtenir de l'aide. Vous pouvez également consulter la page d'état de Cloudflare pour voir s'ils connaissent actuellement une panne.

502 Mauvaise passerelle chez Cloudflare (variante 2)

Si vous voyez l'écran suivant, il s'agit d'un problème avec votre hébergeur.

Pare-feu GoDaddy

Voici un autre exemple avec une erreur HTTP 502 et le pare-feu de GoDaddy. Le problème concerne en fait le serveur d'origine (le fournisseur d'hébergement) en raison d'un délai d'attente, et non le pare-feu lui-même.

6. Vérifiez vos plugins et thèmes

Souvent, la raison pour laquelle les scripts et les requêtes sont annulés par le serveur est due à un mauvais code sur votre site WordPress, peut-être à partir d'un plugin ou d'un thème tiers. Nous avons également vu de nombreux plugins de mise en cache mal configurés générer des erreurs 502. Vous pouvez résoudre ce problème de plusieurs manières en désactivant tous vos plugins. N'oubliez pas que vous ne perdrez aucune donnée si vous désactivez simplement un plugin.

Si vous pouvez toujours accéder à votre administrateur, un moyen rapide de le faire est de naviguer jusqu'à "Plugins" et de sélectionner "Désactiver" dans le menu des actions en masse. Cela désactivera tous vos plugins. Si cela résout le problème, vous devrez trouver le coupable. Commencez à les activer un par un, en rechargeant le site après chaque activation. Lorsque vous voyez le retour d'erreur de passerelle 502, vous avez trouvé le plugin qui se comporte mal. Vous pouvez ensuite contacter le développeur du plugin pour obtenir de l'aide ou publier un ticket d'assistance dans le référentiel WordPress.

Si vous ne pouvez pas accéder à votre administrateur, vous pouvez FTP sur votre serveur et renommer votre dossier de plugins en quelque chose comme plugins_old. Ensuite, vérifiez à nouveau votre site. Si cela fonctionne, vous devrez alors tester chaque plugin un par un. Renommez votre dossier de plugins en "plugins", puis renommez chaque dossier de plugins à l'intérieur de celui-ci, un par un, jusqu'à ce que vous le trouviez.

Assurez-vous toujours que vos plugins, thèmes et WordPress sont à jour . Et vérifiez que vous utilisez une version prise en charge de PHP. Vous pouvez toujours contacter votre hôte pour obtenir de l'aide. Nous utilisons Kinsta APM et d'autres méthodes de dépannage ici chez Kinsta pour aider les clients à déterminer quel plugin, requête ou script pourrait être à l'origine de l'erreur. Vous pouvez également utiliser votre propre clé New Relic personnalisée si vous avez votre propre licence.

S'il s'avère être une requête efficace ou un mauvais code dans un plugin, vous devrez peut-être faire appel à un développeur WordPress pour résoudre le problème.

7. Vérifier les journaux

Vous devriez également tirer parti de vos journaux d'erreurs. Si vous êtes un client Kinsta, vous pouvez facilement voir les erreurs dans la visionneuse de journaux dans le tableau de bord MyKinsta. Cela peut vous aider à affiner rapidement le problème, surtout s'il résulte d'un plugin sur votre site.

Si votre hébergeur n'a pas d'outil de journalisation, vous pouvez également ajouter le code suivant à votre fichier wp-config.php pour activer la journalisation :

 define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );

Si vous avez besoin de plus d'aide pour activer le mode de débogage de WordPress, voici un tutoriel complet étape par étape.

Les journaux se trouvent généralement dans le répertoire /wp-content. D'autres, comme ici chez Kinsta, pourraient avoir un dossier dédié appelé "logs".

Vous pouvez également consulter les fichiers journaux dans Apache et NGINX, qui se trouvent généralement ici :

• Apache : /var/log/apache2/error.log
• NGINX : /var/log/nginx/error.log

Si vous êtes un client Kinsta, vous pouvez également profiter de notre outil d'analyse pour obtenir une ventilation du nombre total d'erreurs 502 et voir à quelle fréquence et quand elles se produisent. Cela peut vous aider à résoudre s'il s'agit d'un problème persistant, ou peut-être quelque chose qui s'est résolu de lui-même.

8. Redémarrez PHP

Enfin, vous pouvez également essayer de redémarrer PHP. Si vous êtes un client Kinsta, vous pouvez facilement redémarrer PHP à partir du menu Outils du tableau de bord MyKinsta. Si votre hébergeur ne le fournit pas, vous pouvez toujours ouvrir un ticket d'assistance et lui demander de redémarrer PHP.

9. Problème de délai d'attente PHP

Les délais d'attente PHP se produisent si un seul processus PHP s'exécute plus longtemps que le max_execution_time ou max_input_time défini dans la configuration PHP sur votre serveur. C'est un phénomène courant si vous effectuez de grosses importations WordPress. Lorsque cela se produit, une erreur de serveur 502 s'affiche généralement. Si vous rencontrez un délai d'attente PHP, ces valeurs devront peut-être être élevées.

Vous pouvez vérifier auprès de votre hébergeur WordPress actuel quelles valeurs sont définies sur votre serveur et si elles peuvent être augmentées. Sur la plateforme Kinsta, ces valeurs sont fixées à 300 secondes (5 minutes) par défaut. Les valeurs maximales de délai d'attente PHP disponibles sur notre plate-forme sont basées sur votre plan d'hébergement actuel.

Résumé

Comme vous pouvez le voir, vous pouvez faire plusieurs choses pour dépanner et corriger une erreur de passerelle 502 sur votre site WordPress. Généralement, ce n'est pas du côté client, mais plutôt un problème avec votre hôte. Les plugins et thèmes tiers avec un mauvais code ou des requêtes non optimisées sont également à surveiller. Y a-t-il quelque chose que nous avons manqué? Peut-être avez-vous un autre conseil sur le dépannage des erreurs de passerelle 502. Si oui, faites-le nous savoir ci-dessous dans les commentaires.