Comment réparer l'erreur 502 Bad Gateway dans WordPress

L'un des aspects les plus frustrants de la gestion d'un site Web est de devoir résoudre une erreur lorsque vous ne savez pas pourquoi cela se produit. Certains problèmes, tels que l'erreur de passerelle incorrecte 502, ont de nombreuses causes potentielles. Cela signifie que vous devrez peut-être essayer plusieurs solutions avant de trouver la bonne. Dans cet article, nous allons vous montrer comment naviguer dans cette erreur délicate et la résoudre.

Mettons-nous au travail!

Abonnez-vous à notre chaîne Youtube

Qu'est-ce que l'erreur 502 Bad Gateway (et pourquoi cela se produit)

L'erreur de passerelle incorrecte 502 apparaît de temps en temps et signifie souvent qu'il y a un problème avec votre serveur.

Lorsque vous visitez un site Web, votre navigateur envoie une ou plusieurs requêtes au serveur qui héberge le site. Si tout fonctionne correctement, ce serveur renverra les informations demandées par votre navigateur et le site Web se chargera. D'un autre côté, l'erreur de passerelle incorrecte 502 se produit lorsqu'un serveur renvoie une réponse « invalide ». Cela peut signifier que la connexion a expiré ou peut être le résultat de plusieurs autres problèmes.

Du Mozilla Developer Network, la définition officielle est :

Le code de réponse d'erreur du serveur HyperText Transfer Protocol (HTTP) 502 Bad Gateway indique que le serveur, tout en agissant en tant que passerelle ou proxy, a reçu une réponse non valide du serveur en amont.

Jusqu'à présent, cela peut sembler simple. Cependant, la connexion entre votre navigateur et la plupart des sites Web n'est plus aussi simple qu'auparavant. Par exemple, la demande de votre navigateur peut être acheminée via un serveur proxy avant d'atteindre l'hôte en question, il peut donc être difficile de déterminer où se trouve le problème. De nombreux sites Web utilisent également plusieurs serveurs, ce qui complique encore les choses car l'un d'entre eux pourrait être la cause de l'erreur 502.

Tout cela signifie qu'il existe quelques causes potentielles pour ce code d'erreur particulier. Cela peut être le résultat de :

• Erreurs dans votre base de données.
• Un serveur qui a expiré, actuellement indisponible ou ne fonctionne tout simplement pas comme prévu.
• Le serveur est surchargé de trop de requêtes. Peut-être une attaque DDOS, ou même simplement un pic de trafic plus important que prévu.
• Un problème avec votre serveur proxy inverse.
• Scripts PHP défectueux, gracieuseté de l'un de vos plugins ou thèmes.

La bonne nouvelle est que si le problème est côté serveur, vous n'aurez peut-être pas besoin de prendre de mesures. Dans ces cas, votre fournisseur d'hébergement sautera généralement à la rescousse rapidement (car les clients ont tendance à ne pas apprécier les temps d'arrêt). Vous devez vous assurer de contacter l'équipe d'assistance de votre hébergeur dès que possible après avoir reçu l'avis que votre site est affecté par une erreur 502.

Dans cet esprit, nous allons nous concentrer sur ce qu'il faut faire si l'erreur de passerelle incorrecte 502 ne disparaît pas d'elle-même rapidement. Après tout, la plupart des sites Web ne peuvent pas se permettre de rester en panne pendant des heures, donc si cette erreur persiste, il est temps de commencer le dépannage de votre côté.

Comment réparer l'erreur 502 Bad Gateway

Avant de passer en mode dépannage, vous pouvez effectuer un test rapide pour déterminer si votre serveur répond comme il se doit. Vous pouvez essayer d'exécuter un traceroute, pour voir si votre serveur est accessible en premier lieu. Si c'est le cas, le problème est probablement de votre côté. Sinon, c'est à ce moment-là que vous voudrez peut-être entrer en contact avec votre fournisseur d'hébergement.

Vous devriez également essayer de réinitialiser votre routeur et de vérifier les paramètres de votre système de noms de domaine (DNS). Ce sont des correctifs de base qui peuvent parfois faire disparaître l'erreur 502, et ils sont assez faciles à résoudre par vous-même. Si vous constatez qu'aucune des deux solutions ne résout le problème, vous pouvez utiliser les méthodes suivantes pour résoudre l'erreur 502.

Videz le cache de votre navigateur

L'erreur 502 peut apparaître lorsque vous essayez d'accéder à votre site Web, même si le problème sous-jacent a été résolu. Cela se produit si votre navigateur s'appuie sur son cache plutôt que de charger la dernière version de votre site à partir du serveur.

Le simple fait de recharger le site plusieurs fois peut souvent faire l'affaire. Surtout si vous utilisez le rechargement forcé via Shift-CTRL-R sur Windows ou Shift-CMD-R sur Mac.

Si tout ce qui précède échoue, vous devez vider manuellement le cache de votre navigateur. Les utilisateurs de Chrome peuvent le faire en accédant au menu Paramètres > Avancé et en localisant l'option Effacer les données de navigation :

Recherchez l'option Images et fichiers mis en cache sous l'onglet De base , puis cliquez sur Effacer les données après l'avoir sélectionnée. Gardez à l'esprit que ce menu supprimera également votre historique de navigation, si vous ne désactivez pas ce paramètre avant de cliquer sur le bouton Effacer les données .

Ce même processus peut également être effectué à l'aide de Firefox, Safari, Internet Explorer et à peu près n'importe quel autre navigateur. Lorsque vous avez vidé le cache, essayez de recharger votre site Web une fois de plus. Si l'erreur persiste, il est temps de passer aux choses sérieuses. Pour plus d'informations sur la suppression du cache, vous pouvez le trouver sur la page hub de Hubspot sur le sujet.

Désactivez temporairement votre réseau de diffusion de contenu (CDN)

Plus tôt, nous avons mentionné que les demandes de votre navigateur seront parfois acheminées via un serveur proxy inverse. En d'autres termes, l'utilisation d'un serveur proxy place un intermédiaire entre le navigateur de l'utilisateur et le serveur du site.

Certains services, tels que les réseaux de diffusion de contenu (CDN), s'appuient sur la technologie de proxy inverse pour acheminer le trafic entrant aussi efficacement que possible. Cependant, cette couche supplémentaire peut parfois créer des problèmes lorsque vous essayez de vous connecter au serveur d'origine d'un site Web. Lorsque cela se produit, vos visiteurs (et vous) peuvent rencontrer la redoutable erreur de passerelle 502 mauvaise.

Heureusement, il est assez facile de vérifier et de voir si votre CDN est à l'origine de ce problème. Tout ce que vous avez à faire est de désactiver temporairement le service, puis de tester si votre site Web se charge correctement sans lui. Le processus de désactivation de votre CDN variera en fonction du service que vous utilisez, mais il est généralement simple.

Par exemple, les utilisateurs de Cloudflare n'ont qu'à accéder à l'onglet Présentation de leur tableau de bord. À l'intérieur, vous trouverez une liste des propriétés qui exécutent le service. Ensuite, vous devrez rechercher le gros bouton Pause dans la section Pause du site Web et cliquer dessus :

Désormais, lorsque vous essayez d'accéder à votre site Web, son serveur d'origine répondra à la demande sans qu'aucun intermédiaire ne vous gêne. Si l'erreur 502 a disparu, votre CDN était probablement la source du problème. Dans la plupart des cas, il vous suffira d'attendre quelques heures avant de réactiver le service. Bien sûr, assurez-vous de vérifier et de vous assurer que l'erreur a toujours disparu par la suite.

Si vous utilisez un autre CDN, vous devrez consulter sa documentation pour savoir comment désactiver temporairement le service. Cependant, s'il s'avère que votre CDN n'est pas le problème, vous pouvez essayer une autre solution.

Tester les thèmes et plugins WordPress

Jusqu'à présent, nous avons parlé de trois causes potentielles derrière l'erreur 502 : votre serveur, votre navigateur et les services intermédiaires tels que les CDN. Cela ne laisse qu'une option si vous êtes sûr que le problème est de votre côté, et c'est votre site Web. Si vous utilisez spécifiquement WordPress, l'un de vos plugins ou thèmes essaie peut-être d'exécuter un script que votre serveur ne peut pas charger correctement. Cela peut entraîner une réponse invalide lorsque votre navigateur envoie une demande, déclenchant l'erreur 502.

Vous ne pouvez avoir qu'un seul thème actif à la fois, vous pouvez donc simplement désactiver votre thème actuel et passer temporairement à un thème WordPress par défaut, pour voir si cela résout l'erreur. D'un autre côté, déterminer si un plugin cause des problèmes peut prendre plus de temps, selon le nombre d'entre eux actuellement actifs.

Comme vous n'avez pas accès à votre tableau de bord pour le moment grâce à l'erreur, vous devrez désactiver vos plugins et thèmes manuellement. Gardez à l'esprit que ce processus n'implique pas la suppression des plugins et des thèmes et que leur réactivation ne prend qu'un instant. Ainsi, la fonctionnalité de votre site Web ne devrait pas être affectée. Même ainsi, vous devriez avoir une sauvegarde récente prête au cas où.

Ensuite, ouvrez le client FTP de votre choix. Nous sommes de grands fans de FileZilla, nous allons donc l'utiliser comme exemple. Connectez-vous à votre site Web via FTP et accédez au dossier public_html – wp-content – ​​plugins . Il devrait y avoir un dossier pour chacun de vos plugins installés à l'intérieur, même ceux qui ne sont pas actifs :

Si vous faites un clic droit sur l'un de ces dossiers, vous verrez plusieurs options, dont une intitulée Renommer . Cliquez dessus maintenant et changez le nom du dossier en quelque chose comme disabled.pluginname :

Lorsque vous accédez à votre site Web maintenant, WordPress ne pourra pas trouver ce plugin, il se chargera donc sans lui. Si le plugin que vous venez de désactiver provoquait l'erreur 502, votre site Web devrait se charger correctement. Pour être sûr, pensez à utiliser la commande CTRL + F5 (ou l'équivalent OS X) pour forcer votre navigateur à supprimer son cache avant de recharger le site.

Pour éviter toute confusion, vous devez dépanner un plugin à la fois. Modifiez le nom d'un dossier, essayez de recharger votre site Web et voyez s'il affiche toujours l'erreur 502. Si c'est le cas, restaurez le nom d'origine du dossier. Répétez ce processus avec chaque dossier jusqu'à ce que vous en ayez trouvé un qui cause l'erreur, ou jusqu'à ce que vous ayez testé chaque plugin. Vous pouvez utiliser le même processus pour tester votre thème actif, ce qui obligera WordPress à utiliser l'un de ses thèmes par défaut à la place.

Si l'un de vos plugins ou thèmes est à l'origine de l'erreur 502, vous pouvez le supprimer complètement et rechercher un remplaçant. S'il est obsolète, vous pouvez également essayer de le mettre à jour, pour voir si cela résout le problème. Dans certains cas, le script du problème sera corrigé rapidement, vous pourrez donc toujours reprendre l'utilisation de ce plugin ou de ce thème plus tard.

Autres correctifs rapides (potentiels)

Maintenant, ces correctifs ci-dessus vont probablement trouver et corriger le coupable si l'erreur 502 est causée par quelque chose de votre côté et non du serveur. Si cela ne disparaît pas, n'oubliez pas que nous vous suggérons de contacter votre hébergeur pour le laisser trier le serveur et diagnostiquer tout problème là-bas.

Cela dit, vous pouvez accélérer le processus en effectuant quelques vérifications rapides.

La première de ces vérifications concerne tous les journaux que votre site a pu enregistrer. Si c'est WordPress, il y a plusieurs façons de le voir. Nous avons un article solide sur l'utilisation de ces journaux pour améliorer votre site qui peut être utile ici. Les sites WP exécutant les versions 5.0 ou supérieures sont équipés d'un outil de santé du site que vous pouvez vérifier dans votre tableau de bord d'administration, alors assurez-vous de voir ce qu'il a à dire.

Vous pouvez également vous assurer que les cookies de votre navigateur sont clairs. Ceux-ci sont entièrement séparés du cache, et nous ne voulons pas toujours les effacer. Si vous conservez des informations enregistrées dans votre navigateur, cela les effacera. Mais ces mêmes cookies peuvent également 502 établir la connexion entre vous et ces sites, il peut donc s'agir d'un Catch-22. Quoi qu'il en soit, il est assez facile d'effacer les cookies dans n'importe quel navigateur majeur.

Si votre site échoue, il se peut qu'il y ait quelque chose en arrière-plan qui a juste besoin de plus de temps pour s'exécuter. Vous pouvez augmenter le temps d'exécution autorisé par un site WordPress assez simplement en éditant votre fichier functions.php . Si vous n'êtes pas sur WP, vous pouvez également le faire via .htaccess ou php.ini . Thimpress a un très bon guide sur la façon de faire tout cela.

Enfin, vous pouvez vérifier les erreurs DNS. Par cela, nous entendons que vous avez déplacé des hôtes ou changé pour un autre type de forfait ou de serveur lui-même. Vous avez peut-être ajusté les serveurs de noms ou un certain nombre de choses qui pourraient mal tourner. Les paramètres DNS sont très spécifiques et sujets à une mauvaise configuration. Allez donc dans votre cPanel ou votre tableau de bord, assurez-vous que tout s'aligne entre votre hébergeur et votre registraire de domaine et les paramètres de votre site Web lui-même. Parfois, un fil se croise ou une seule faute de frappe arrête tout dans son élan. Une petite relecture DNS peut faire beaucoup de chemin ici.

Et si vous souhaitez vraiment vous assurer que le DNS est correct de votre côté, vous pouvez lancer le terminal et vider votre cache DNS manuellement.

Conclusion

Résoudre les erreurs WordPress est souvent plus facile que vous ne le pensez. Même les problèmes qui ont de nombreuses causes potentielles, comme l'erreur de passerelle incorrecte 502, sont bien compris et documentés. Vous devrez peut-être essayer plusieurs solutions avant d'en trouver une qui fonctionne, mais le processus de dépannage ne devrait pas prendre trop de temps si vous suivez les bonnes instructions.

Si vous rencontrez l'erreur de passerelle incorrecte 502 sur votre site Web et qu'elle ne disparaît pas après quelques minutes (ou après un appel rapide à l'équipe d'assistance de votre hôte), il y a de fortes chances que le problème soit de votre côté. Suivez simplement les processus et astuces que nous avons mentionnés ci-dessus, et vous et vos utilisateurs devriez être de retour sur votre site Web en un rien de temps.

Avez-vous déjà rencontré l'erreur 502 bad gateway sur l'un de vos sites Web ? Partagez vos expériences avec nous dans la section commentaires ci-dessous!

Image miniature de l'article par windwheel / shutterstock.com.