L’erreur 502 Bad Gateway représente un code d’état HTTP indiquant qu’un serveur web a obtenu une réponse erronée de la part du serveur d’origine. Ce type d’erreur qui s’affiche dans la fenêtre du navigateur comme les pages web, n’a absolument rien avoir avec la façon dont votre ordinateur a été configuré. Ce qui signifie que vous pouvez l’apercevoir sur tous les navigateurs, tous les systèmes d’exploitation ou tous les périphériques.

Il n’est pas rare de voir lors du chargement d’une page certains nombres de codes d’erreur appelés code d’état, nous stipulant clairement qu’une page n’est pas disponible ou de patienter un moment ou carrément de cliquer sur un lien pour être redirigé.

Parmi ces codes existe l’erreur 502 Bad Gateway qui empêche souvent les internautes ou webmasters d’accéder au contenu ou à la requête recherchée. Ce n’est visiblement pas une partie de plaisir pour ceux qui rencontrent ce genre d’erreur.

Vous avez été peut-être déjà sujet à celle-ci, et vous n’avez pas su forcément comment réagir, comment la corriger ou comment tout simplement contourner cette catégorie d’erreur pour obtenir gain de cause sur votre requête.

Comme vous pouvez le comprendre, il existe une manière bien précise d’aborder l’erreur 502 Bad Gateway, et c’est ce que nous allons voir dans cet article en apportant des réponses à ces questions :

• Que signifie une erreur 502 ?
• Quelles en sont les causes ?
• À quoi peut-elle ressembler ?
• Comment réparer l’erreur 502 Bad Gateway ?

Suivez scrupuleusement cet article pour ne plus vous faire avoir par cette catégorie d’erreurs. On commence !

Chapitre 1 : Erreur 502 Bad Gateway : De quoi s’agit-il ?

Les erreurs Bad Gateway constituent les erreurs de serveurs fréquemment rencontrés par les internautes ainsi que les détenteurs de sites internet WordPress.

Dans ce chapitre je vous expliquerai, ce qu’est une erreur 502, à quoi elle peut ressembler, les causes qui peuvent être à la source, ainsi que leurs impacts sur le référencement.

1.1. Que veut dire erreur 502 Bad Gateway ?

Pour mieux définir ce qu’est une erreur 502 Bad Gateway, il est d’abord important de se familiariser avec la notion des serveurs, et de comprendre le sens de certains termes tels que : 

• Serveur web ;
• Serveur proxy ou passerelle ;
• Et serveur en amont, d’origine ou de base.

Commençons d’abord par voir comment se déroule l’hébergement d’une application web moderne. Pour ce fait, il est nécessaire d’avoir trois éléments :

• L’application web ;
• La passerelle ;
• Le serveur web.

Sur l’image ci-dessous, vous pouvez retrouvez le processus que suit une application web moderne PHP (Hypertext Preprocessor).

Une application web se présente sous la forme d’un logiciel d’application pouvant être codée dans plusieurs langages de programmation différents et peut recourir à des frameworks ou des bibliothèques spécialisées.

Elle possède souvent des mécanismes permettant de traiter les requêtes HTTP. Dans le cas de votre site web wordpress, l’application web peut correspondre à votre site wordPress, lequel est codé en PHP.

La passerelle (Gateway) quant à elle, est située entre un serveur web comme Nginx ou Apache et une application web. Elle a pour rôle de recevoir les requêtes d’un serveur (en amont ou d’origine) puis de les interpréter pour une application web. L’expression passerelle n’est pas très facile à définir.

Certaines se désignent comme des gestionnaires de processus, d’autres comme des serveurs HTTP.

Les caractéristiques communes d’une passerelle sont les suivantes :

• Réception des demandes (HTTP, FastCGI, uWSGI, etc.) ;
• Traduction des demandes en code d’application ;
• Création de plusieurs processus ;
• Contrôle des processus créés ;
• Répartition des demandes entre les processus ;
• Rapports/journaux.

PHP-FPM ou PHP-FastCGI Process Manager est la passerelle vers PHP. Il s’agit d’une mise en œuvre de FastCGI qui écoute les requêtes FastCGI émises par un serveur web.

FastCGI est un mécanisme binaire qui permet de relier des programmes interactifs à un serveur web. Le CGI (Common Gateway Interface) constitue une technologie et un programme web permettant de décrire la façon dont un serveur web peut communiquer avec des applications externes, notamment le PHP.

Le CGI est donc un intermédiaire entre le serveur web et les contenus web qui sont produits par des applications web développées dans divers langages de programmation, comme PHP ou Python. FastCGI n’est qu’une version optimisée du CGI.

En ce qui concerne le serveur web, il dispose de plusieurs fonctions :

• Il héberge plusieurs sites ;
• Il fournit des fichiers statiques ;
• Il transmet des requêtes à d’autres serveurs ;
• Il effectue la répartition des charges ;
• Il assure la mise en cache des HTTP.

Il faut mentionner que les deux serveurs web les plus célèbres sont Apache et Nginx. Autrefois, Apache était le serveur web le plus utilisé avant que Nginx ne devienne plus répandu.

À présent que les termes mentionnés ci-dessous sont bien compris, vous allez enfin bien comprendre ce que représente une erreur 502 Gateway.

1.1.1. Qu’est-ce qu’une erreur 502 Bad Gateway ?

On parle d’erreur 502 Gateway, lorsque le serveur web se comporte comme un serveur passerelle et obtient une réponse invalide depuis le serveur en amont. Une erreur 502 Bad Gateway signifie que le serveur proxy représentant le serveur passerelle ne parvient pas à avoir un bon résultat du serveur en amont (serveur de base).

Si vous remarquez une erreur 502 Bad Gateway, cela veut dire qu’il y a une chose qui n’est pas en règle avec le serveur en amont. Il existe pas mal de raisons à cela que nous verrons dans les paragraphes qui suivent.

1.1.2. Les divers types d’erreurs 502 Bad Gateway

Il y a plusieurs types de serveurs web, de systèmes d’exploitations ou de navigateur web employés par les utilisateurs. À titre d’exemple, vous vous servez peut-être du navigateur Google Chrome et macOS. Dans le même temps, d’autres personnes se servent peut-être de Firefox et le système d’exploitation Windows 10.

Plus encore, certains sites web sont capables de personnaliser la forme que doit prendre l’erreur 502 Bad Gateway, lorsqu’elle s’affiche aux utilisateurs.

Cependant, ces différentes variantes possèdent la même signification, celle qui stipule qu’un serveur qui servait de passerelle ou d’office a obtenu une réponse invalide d’un serveur d’origine ou en amont.

Voici quelques façons les plus fréquentes dont vous pouvez apercevoir l’erreur 502 Bad Gateway :

• 502 Bad Gateway ;
• Erreur de serveur 502 : Le serveur a rencontré une erreur temporaire et n’a pas pu répondre à votre demande ;
• HTTP 502 ;
• Erreur 502 ;
• Erreur temporaire (502) ;
• 502 Service temporairement surchargé ;
• 502. C’est une erreur ;
• Erreur de proxy 502 ;
• 502 mauvaise passerelle Cloudflare ;
• Erreur HTTP 502 – mauvaise passerelle ;
• 502 Bad Gateway NGINX.

Certaines plateformes ou d’autres services peuvent choisir des moyens différents d’afficher l’erreur 502. Twitter par exemple, montre un tout autre message qui dit : « Twitter est en surcharge ». C’est tout ce que nous savons. »

Source : Exai

Le moteur de recherche Google l’affiche également sous une forme totalement différente. Si en vous servant de son navigateur, vous tombez sur cette erreur, vous pouvez voir apparaître un message qui dit :

« 502. C’est une erreur. Le serveur a rencontré une erreur temporaire et n’a pas pu répondre à votre demande. Veuillez réessayer dans 30 secondes. C’est tout ce que nous savons.« 

Source : Exai

1.1.3. Incidence de l’erreur 502 sur le référencement de votre site Web

Lorsque l’erreur 502 devient courante sur votre site web, elle peut impacter négativement le SEO de celui-ci. En effet, cette erreur affecte la réputation de votre page web, que ce soit pour les internautes ou pour les moteurs de recherche.

Au final, cela conduit à une mauvaise expérience pour les consommateurs dans la mesure où il est même préférable, à celui qui gère un site qui présente d’erreurs aussi souvent, de délaisser son rôle.

Car, si cette erreur subsiste pendant une longue période de temps sur votre site, il y a de fortes probabilités que le site se fasse entièrement désindexer des moteurs de recherches.

Ceci pour l’ultime raison que ce site n’est plus en mesure de fournir des données aux internautes, ce qui provoquera une augmentation des taux de rebond et la chute des classements.

Avec cet impact néfaste que peut avoir cette erreur sur votre site, vous vous demandez sûrement ce qui pourrait réellement en être la source. Voici les causes probables d’une erreur 502.

1.2. Les causes d’une erreur 502 Bad Gateway

Les erreurs 502 sont dues au fait que le serveur a été incapable de fournir une réponse valide à la requête formulée. C’est du moins ce qui a été dit jusqu’à présent. Mais vous devez savoir que d’autres raisons peuvent aussi être à la source de cette catégorie d’erreur.

Voici les causes les plus fréquentes :

• Le serveur de base est hors service ;
• Le nom de domaine ;
• Requête bloquée par le pare-feu ;
• Défaillance du serveur ;
• Problème lié au navigateur.

1.2.1. Le serveur d’origine est hors service

L’une des raisons qui peuvent vous amener à rencontrer une erreur 502 réside dans le fait que le serveur soit hors service ou ne fonctionne pas bien. Cela voudrait dire également que le serveur n’est pas accessible. 

Cette situation peut s’expliquer de plusieurs façons :

• Soit le serveur est en panne ;
• Soit il existe un problème de connectivité ;
• Ou soit le trafic sur le serveur est très élevé.

1.2.2. Le nom de domaine

L’erreur 502 Bad Gateway peut également s’expliquer par le fait que le domaine ne parvient pas à déterminer la bonne adresse IP. Ce problème est souvent dû à des enregistrements DNS erronés, effectués au niveau de l’hébergement du domaine.

Même si les enregistrements DNS que vous avez définis sont exacts, il ne faut pas oublier que les modifications apportées au DNS mettent du temps à se propager à tous les niveaux sur internet. Ce temps peut dépendre de pas mal de facteurs dont la durée de vie ou le TTL.

1.2.3. Requête bloquée par le pare-feu

Le pare-feu permet de bloquer toute forme de transmission entre les serveurs. Il constitue une autre raison courante pour laquelle vous êtes confrontées à l’erreur 502. 

Il peut arriver que les plugins de sécurité de WordPress :

• Empêchent la communication entre les différents serveurs ;
• Ou bloquent votre adresse IP locale ou celle de votre fournisseur d’accès.

Pour écarter cette éventualité, vous pouvez tenter de vous rendre sur le site en utilisant une autre connexion internet.

Par ailleurs, certains systèmes de protection contre les attaques DDOS peuvent être trop sensibles au point de bloquer les requêtes des serveurs.

1.2.4. Défaillance du serveur

L’autre cause de la rencontre d’une erreur 502 Bad Gateway, est lorsque le serveur se retrouve totalement en défaillance. Celle-ci peut provenir d’un dysfonctionnement du système ou parfois, le serveur est mis hors service pour des raisons de maintenance, etc.

Cette défaillance peut également provenir du fait que le contenu semble violer les termes et conditions du fournisseur du serveur.

1.2.5. Problème lié au navigateur

Il est important de savoir que, certaines extensions de navigateurs peuvent également être à l’origine des erreurs au moment du chargement du site Web, en particulier les extensions AdBlock.

Mis à part cela, il peut y avoir de rares cas où l’erreur est due à une version obsolète du navigateur.

Vous savez à présent ce qu’est une erreur 502 Bad Gateway, ses causes et son impact sur le référencement. Voyons donc les différentes méthodes à pratiquer pour y remédier.

Chapitre 2 : Les méthodes pour dépanner une erreur 502 Bad Gateway

Plusieurs techniques sont utilisées pour réparer les erreurs 502 Bad Gateway qui survienne. En parlant de ces méthodes, j’aurai à les présenter en deux catégories :

• Celles qui concernent l’utilisateur ;
• Et celles que doivent mettre en œuvre les développeurs.

2.1. Les méthodes employées en cas d’erreur Bad Gateway pour les utilisateurs

2.1.1. Actualiser la page

Lorsque vous êtes en face d’une erreur 502, la probabilité est très forte que le serveur du site internet soit submergé par un volume de trafic plus important que celui qu’il peut gérer d’habitude.

Si vous êtes dans ce cas, vous pouvez tenter de résoudre cette erreur en actualisant la page. Pour le faire, il suffit de cliquer sur les touches Ctrl + R ou F5 figurant sur votre clavier afin de recharger la page.

Cette erreur peut s’avérer être juste temporaire survenue durant la période où le serveur est soumis à un trafic intense où à une éventuelle attaque DDOS.

En essayant donc d’actualiser à nouveau la page quelques minutes plus tard, il est possible que vous ne voyiez plus cette erreur.

Source : wpoven

2.1.2. Essayez en mode navigation privé (incognito)

Une autre méthode pour résoudre cette erreur consiste dans le fait de lancer une nouvelle session privée ou incognito sur votre navigateur. Tout ce que vous avez à faire est de fermer les onglets qui existaient puis de démarrer une toute nouvelle session privée ou en mode incognito.

Si l’erreur est survenue à cause d’un problème sur votre navigateur, le fait de redémarrer votre navigateur sur une session privée peut permettre de résoudre le problème.

2.1.3. Effacer le cache du navigateur

Il peut arriver que des fichiers endommagés conservés sur votre navigateur puissent être à la source de l’erreur 502 Bad Gateway. Par conséquent, si vous supprimez les données de la mémoire cache de votre navigateur, cette erreur peut être résolue.

Par ailleurs, je vous conseille également d’effacer les cookies de votre navigateur. Cela pourrait aussi aider à corriger cette erreur.

Source : Wpoven

2.1.4. Tester d’autres navigateurs

Il existe plusieurs autres navigateurs que vous pouvez essayer, si celui que vous utilisez vous présente une erreur 502. Faites l’essai d’un autre navigateur comme :

• Chrome ;
• Safari ;
• Fireforce ;
• Internet Explorer. 

Si l’erreur n’apparaît plus lorsque vous changez de navigateur, cela veut sans doute dire que votre ancien navigateur est la base du problème. Il est également possible de réinstaller le navigateur pour voir si le problème est résolu.

2.1.5. Relancez votre périphérique réseau

Le fait de redémarrer votre périphérique réseau peut également résoudre une erreur 502 Bad Gateway. Il vous faut simplement arrêter la connexion de votre modem internet. Pour faire cela, vous devez débrancher votre modem internet en gardant la touche appuyée durant 10 secondes.

Une fois que ces signaux sont totalement éteints, il faut le rebrancher, activer le bouton de mise sous tension et patienter jusqu’à ce que votre ordinateur puisse établir une nouvelle connexion.

2.1.6. Effacer le cache DNS 

L’erreur 502 Bad Gateway est capable de survenir pour des raisons de dysfonctionnement de DNS. Vous pouvez voir les systèmes d’exploitation comme Linux, Windows ou macOS, faire le stockage des données relatives à la résolution des problèmes de nom sous la forme d’un cache DNS.

Dans beaucoup de cas, le fait de supprimer le cache DNS peut permettre de remédier à une erreur 502 Bad Gateway. Vous trouverez ci-dessous les différentes commandes dont vous pouvez vous servir pour supprimer le cache DNS sur Windows, MacOs et Linux.

Pour supprimer le cache sous Windows, servez-vous de la commande suivante :

ipconfig/flushdns

Pour macOS, il vous faut ouvrir le terminal et saisir :

sudo killall -HUP mDNSResponder

Aucun message n’est affiché après le traitement de cette commande, en revanche, il est possible d’ajouter le vôtre en effectuant la commande de la manière suivante :

sudo killall -HUP mDNSResponder; dns cleared successfully

La situation est différente sous Linux, car les diverses distributions de Linux font appel à divers services DNS. Il s’agit notamment de :

• NSCD (Name Service Caching Diamond) ;
• Dnsmasq ;
• Bind (Berkeley Internet Name Domain).

Concernant le cache DNS NSCD :

sudo /etc/init.d/nscd restart

Dans le cas d’un cache DNS dnsmasq :

sudo /etc/init.d/dnsmasq restart

Pour ce qui est des caches DNS BIND, voici la commande à saisir :

sudo /etc/init.d/named restart

sudo rndc restart

sudo rndc exec

Au cas où le terminal vous demanderait un mot de passe, il suffit de la saisir.

Vous pouvez également de modifier de façon temporaire vos serveurs DNS.

2.1.7. Les méthodes à employer si vous utilisez Cloudflare

Face à un serveur d’origine qui envoie un message d’erreur classique HTTP 502 Bad Gateway, Cloudflare affiche une erreur 502 de sa propre marque : 502 bad gateway appearance.

Source : 10weblog

Cela veut dire qu’il y a quelque chose qui cloche avec votre serveur d’origine. Voici les conseils à suivre, pour remédier à ce problème.

Lorsque l’erreur 502 émane de Cloudflare, la page se présente comme suit :

Source : 10 weblog

Si le mot “Cloudflare” figure sur l’erreur, cela signifie que le serveur provient de Cloudflare, autrement, il vient du serveur d’origine. Au premier abord, il est conseillé de se référer au service d’assistance de Cloudflare, ou choisir de suivre les conseils décrits. Si aucun changement positif n’est constaté, prenez contact avec votre fournisseur d’hébergement.

Vous venez de voir quelques conseils qui vont vous permettre de réparer une erreur Bad Gateway côté utilisateurs. Suivez à présent ce que vous pouvez faire côté développeur ou serveur.

2.2. Les méthodes à utiliser en cas d’erreur 502 Bad Gateway pour les développeurs

Vous êtes développeur ou gestionnaire de serveur et vous êtes confronté à cette erreur ? Il y a de fortes probabilités que cela soit lié à des facteurs différents de ce qu’on a pu voir précédemment.

Voici des méthodes recommandées pour résoudre ce problème.

2.2.1. Examiner le serveur et le DNS

Une manière de déterminer si votre serveur est accessible ou non consiste à effectuer un test de traçage ou de ping sur l’IP du serveur. 

Vous pouvez également vérifier si votre nom de domaine complet est bien défini ou non. Comme cela a été mentionné ci-dessus.

2.2.2. Vérifier les journaux d’erreur

Une autre possibilité s’offre aux développeurs est celui de vérifier les journaux d’erreur du serveur ou du site créé sur celui-ci, pour voir si une erreur spécifique est signalée sur le serveur. Si vous utilisez WordPress, vous pouvez ajouter ces différents codes sur votre fichier wp-config.php.

Source : Wproven

Ce faisant, vous pouvez avoir toutes les données en rapport avec les erreurs qui sont survenues à partir d’une quelconque application nouvellement ajoutée. Vous verrez également tous les éléments qui ont causé des erreurs que votre site a produites.

2.2.3. Examinez les plugins et les thèmes de votre WordPress

La présence de codes non optimisés dans les plugins et les thèmes WordPress peut aussi entraîner des erreurs 502 Bad Gateway. Je vous conseille donc de contrôler vos thèmes et vos plugins WordPress.

Si vous disposez du droit d’accès à votre administration WordPress, essayez donc de désactiver tous vos plugins. Si l’erreur disparaît après ce procédé, cela veut dire qu’il existe tout au moins un plugin responsable de l’erreur.

Commencez donc à trier chaque plugin en les activant un par un afin de trouver les plugins fautifs. Si vous n’avez pas accès à l’administration WordPress, suite à l’erreur, mais que vous arrivez à accéder à vos fichiers WordPress, il vous suffit simplement de renommer le dossier plugins dans wp-content.

Cela aura pour effet de désactiver tous les plugins, ensuite reprenez leurs activations un par un. Si la désactivation de tous les plugins ou le renommage du répertoire des plugins ne change rien, tentez de changer momentanément votre thème pour le thème par défaut de WordPress.

Après avoir trouvé les plugins ou le thème en défaillance, contactez l’équipe d’aide puis exposez votre situation.

Surtout, gardez à l’esprit de toujours mettre à jour vos plugins, votre thème ou le moteur de WordPress. Cela vous permettra d’éviter beaucoup de problèmes y compris, les erreurs 502.

Suivez notre article sur comment installer un thème sur wordPress 

2.2.4. Examinez votre Pare-Feu

Vous pouvez également vérifier les historiques du pare-feu afin de repérer d’éventuels blocages inhabituels. Une mauvaise configuration du pare-feu peut causer une erreur 502 Bad Gateway. 

Un pare-feu représente un système de sécurité réseau qui permet de surveiller le flux entrant et sortant du réseau selon des règles de sécurité bien préalablement définies.

Il peut arriver que certaines configurations inadéquates du pare-feu considèrent comme malveillant un contenu conforme et sûr, par conséquent, bloquent le trafic, ce qui provoque à son tour des erreurs 502 Bad Gateway. 

Pour pallier ce problème, il vous faut désactiver momentanément les pare-feu pour voir si le problème perdure ou a été résolu.

2.2.5. Désactiver momentanément le CDN

L’autre raison qui peut être à l’origine de l’erreur 502 est le fait que votre serveur soit sujet d’une attaque DDOS. Dans ces conditions, vous avez la possibilité d’employer des services comme Fail2ban pour tenter de verrouiller les adresses IP offensives.

Vous pouvez également employer des fournisseurs de CDN comme Cloudflare, afin de minimiser tous types d’attaques DDOS visant le serveur.

2.2.6. Redémarrer le service PHP-FPM

Il est important de savoir qu’une erreur 502 peut s’afficher quand le service PHP-FPM n’est pas actif ou ne marche pas sur le serveur. Si vous disposez d’un accès à l’hébergement, il est possible de le vérifier en utilisant l’une des commandes ci-après.

Pour la commande SysVinit : 

sudo service php7.4-fpm status

Pour ce qui est du SystemD :

sudo systemctl status php7.4-fpm

Si le service PHP-FPM est actif et fonctionnel, le résultat de la commande ressemblera à ceci :

Source : 10web

Si en revanche le statut indiqué n’est pas : “actif”(en cours d’exécution), il convient d’essayer de redémarrer le service PHP-FPM afin de réparer l’erreur grâce aux commandes suivantes.

Dans le cas de SysVinit :

sudo service php7.4-fpm restart

Concernant le SystemD :

sudo systemctl restart php7.4-fpm

2.2.7. Les fautes relatives au délai d’attente

L’erreur 502 est parfois provoquée par un dépassement de délai de PHP-FPM. Si l’application prend beaucoup de temps pour donner une réponse, les internautes pourront constater une erreur de délai d’attente.

Si le temps d’attente de PHP-FPM est plus court que celui de Nginx, Nginx affichera une erreur 502 Bad Gateway. Pour éviter ce problème, il est possible d’augmenter le délai d’attente (timeout) de PHP-FPM, si vous disposez d’un accès au serveur.

Le délai d’attente de PHP-FPM est fixé dans le paramétrage du pool, à savoir

request_terminate_timeout

Les défauts de temps d’exécution de PHP peuvent également être à la base des erreurs 502 Bad Gateway. Pour y remédier, il suffit d’augmenter les paramètres de configuration de PHP, tels que max_exexexution_time et max_input_time.

Si vous pouvez accéder à votre serveur, vous pouvez simplement changer ces directives dans votre fichier php.ini. Autrement, il est possible de demander à votre hébergeur de se charger de la tâche.

Résumé

À présent vous ne devez plus paniquer quand vous tombez sur une erreur 502 Bad Gateway en cours de route. Cette dernière est une erreur liée à un problème de transmission entre les serveurs. Elle représente principalement un code d’état qui signifie que le serveur proxy n’arrive pas à obtenir une réponse valide du serveur de base.

Plusieurs causes peuvent être à l’origine de cette erreur. Elle peut également avoir des incidences négatives sur le référencement de votre site internet. C’est pourquoi il est idéal de prendre en compte immédiatement cette erreur surtout quand elle devient récidive.

C’est dans cette optique que j’ai eu à vous présenter dans cet article, les différentes méthodes à exercer pour résoudre cette erreur, aussi bien chez le développeur que chez l’utilisateur.

J’espère que cet article vous a été utile. J’attends avec impatience vos commentaires.