Qui renvoie l'erreur 502 ? Diagnostiquer un Bad Gateway derrière un proxy
Updated:
Une erreur 502 Bad Gateway via un proxy signifie qu'un serveur intermédiaire a transmis votre requête et n'a reçu aucune réponse exploitable. Ce serveur intermédiaire peut être votre proxy, ou bien le répartiteur de charge ou le CDN du site web. La solution en dépend entièrement : identifiez donc l'émetteur avant de modifier vos paramètres.
Que signifie l'erreur 502 Bad Gateway avec un proxy ?
Une erreur 502 Bad Gateway signifie qu'un serveur intermédiaire a demandé la page à un autre serveur et n'a reçu aucune réponse exploitable. Derrière un proxy, deux serveurs peuvent jouer ce rôle : le proxy lui-même, ou le répartiteur de charge / CDN du site web. La plupart des erreurs 502 observées via un proxy fonctionnel proviennent du site web ; la première étape consiste donc à identifier qui l'a émise.
Avec une adresse https://, un proxy se contente d'établir un tunnel ; il ne peut pas injecter sa propre page d'erreur au sein de la connexion chiffrée. Si le proxy ne parvient pas à monter ce tunnel, Chrome affiche ERR_TUNNEL_CONNECTION_FAILED, et non une page web. Une page « 502 Bad Gateway » affichée sur un site HTTPS provient donc presque à coup sûr de l'infrastructure même du site.
Pour en avoir le cœur net, désactivez le proxy et ouvrez la même page directement. Une erreur 502 constatée sans proxy indique que le site web rencontre des difficultés. Il vous suffit alors de patienter ou de contacter l'administrateur du site.
Erreur 502 Bad Gateway : causes, symptômes et solutions
Chaque cause laisse une trace distincte. Identifiez votre situation dans le tableau ci-dessous avant de modifier vos paramètres ou de remplacer vos proxys.
| Cause | Symptôme | Solution |
|---|---|---|
| Le serveur d'origine du site web est hors ligne ou surchargé | Une page 502 personnalisée par le site ou son CDN, également visible sans le proxy | Patientez ou prévenez l'administrateur du site ; aucune action requise de votre côté |
| La cible ne répond jamais au proxy | CONNECT tunnel failed, response 502 dans curl ; les autres sites se chargent correctement | Réessayez plus tard, réduisez la fréquence de vos requêtes vers ce site ou utilisez une IP d'un autre pays |
| Le nom d'hôte ne peut pas être résolu | Erreur 502 uniquement sur un domaine mal orthographié ou abandonné | Corrigez l'URL ; avec SOCKS5, utilisez socks5h:// pour que le proxy effectue la résolution |
| Aucun service n'écoute sur le port demandé | Erreur 502 sur un port non standard comme :8443 | Vérifiez le port dans l'URL et testez la même adresse sans ce port |
| Panne passagère du proxy | Tous les sites renvoient une 502 avec ce proxy alors qu'un autre proxy fonctionne | Testez la ligne sur le proxy checker et ouvrez un ticket avec le résultat obtenu |
Manifestation d'une erreur 502 générée par un proxy
Nous avons forcé notre proxy de test à renvoyer une 502 et enregistré le comportement de chaque client (adresse et identifiants remplacés par 203.0.113.10:8080 et user123:pass456) :
| Client | Comportement observé |
|---|---|
| curl, cible HTTPS | curl -x http://user123:[email protected]:8080 https://example.com renvoie curl: (56) CONNECT tunnel failed, response 502 |
| curl, cible HTTP standard | Code de statut 502 |
| Chrome, page HTTPS | ERR_TUNNEL_CONNECTION_FAILED, sans affichage de page 502 |
| Testeur de proxy ProxyV4 | HTTP 502 (tout autre code de statut apparaît sous la même forme : HTTP <code>) |
Comment résoudre une erreur proxy 502 Bad Gateway dans votre client
La démarche reste identique partout : vérifiez que le proxy fonctionne sur un second site, puis décidez s'il faut patienter, ralentir ou changer de cible. Seul l'endroit où chaque outil signale l'erreur change.
Chrome, Firefox et Edge
Une page 502 complète sur un site https:// provient du site lui-même. Une erreur de tunnel comme ERR_TUNNEL_CONNECTION_FAILED provient du proxy. Ouvrez un autre grand site dans la même fenêtre : s'il s'affiche, le proxy est opérationnel. Sur smartphone, désactivez le proxy Wi-Fi et chargez la page en données mobiles pour voir si le problème est général.
curl
Exécutez curl -v -x http://IP:PORT -U 'USER:PASS' https://example.com et examinez la ligne située après CONNECT. Si un code 502 y figure, il a été émis par le proxy ; réessayez avec un autre domaine pour déterminer si l'erreur vient du site ou du proxy. La page de configuration curl répertorie les autres codes de sortie.
Python requests
Pour les pages HTTP simples, vérifiez si response.status_code == 502 et réessayez après une pause. Pour les pages HTTPS, l'échec du tunnel lève l'exception requests.exceptions.ProxyError contenant Tunnel connection failed: 502 dans le message. Espacez vos tentatives avec un repli progressif plutôt que de les enchaîner sans pause ; l'article Python requests ProxyError détaille cette exception.
Selenium et Puppeteer
Chrome en mode headless signale une 502 côté proxy par net::ERR_TUNNEL_CONNECTION_FAILED dans l'erreur levée par goto() ou get(), et une 502 côté site sous forme de page normale avec le statut 502. Avec Puppeteer, lisez response.status() via page.goto() ; avec Selenium, le message de passerelle apparaît généralement dans le titre ou le corps de la page. Si plusieurs sites échouent lors de vos automatisations alors qu'ils fonctionnent sur le testeur, consultez proxy not working.
Navigateurs antidétection
Utilisez d'abord le test de proxy intégré au profil. S'il réussit mais qu'un site affiche toujours une 502, le profil est bien configuré et le site est en cause. Si le test échoue avec une erreur de passerelle, comparez avec le proxy checker : un succès sur ce dernier et un échec dans le profil indiquent un problème de type de proxy ou d'identifiants enregistrés.
Scrapers rencontrant occasionnellement une 502
- Des erreurs 502 occasionnelles sur une cible signifient généralement que le site est saturé. Réduisez votre fréquence de requêtes et ajoutez des retentatives avec des pauses progressives ; la page web scraping aborde la gestion du rythme.
- Enregistrez l'hôte ayant renvoyé l'erreur 502 dans vos journaux. Si elles se concentrent sur un seul domaine, le proxy n'est pas en cause.
- Si tous les hôtes renvoient une 502 via une IP donnée mais pas via une autre, signalez cette IP : il s'agit d'une défaillance du proxy.
Étape par étape
- 1
Observez la forme de l'erreur
Une page 502 complète sur une adresse https incrimine le site web. Une erreur de tunnel dans Chrome indique un problème sur le chemin du proxy.
- 2
Chargez la page sans le proxy
Si l'erreur 502 persiste, le site web lui-même est défaillant et le proxy n'est pas en cause.
- 3
Testez un second site via le proxy
Si d'autres sites fonctionnent, le proxy est opérationnel et seule la destination initiale est inaccessible ou bloque la connexion.
- 4
Passez la ligne dans l'outil de test
Collez-la dans le testeur de proxy. Si chaque cible renvoie
HTTP 502, transmettez ce résultat dans un ticket d'assistance.
Foire aux questions
L'erreur 502 indique-t-elle que mon proxy a expiré ?
Rarement. Un proxy expiré ou arrêté entraîne généralement un échec de connexion ou un délai d'attente dépassé. Consultez proxy timeout pour ce cas.
Pourquoi l'erreur 502 n'apparaît-elle que sur un seul site ?
Ce site rencontre des difficultés ou ne répond pas aux connexions issues de l'IP du proxy. Réessayez plus tard ou utilisez une adresse située dans un autre pays.
502 ou 504 : quelle est la différence ?
Le code 502 signifie que le serveur intermédiaire a reçu une réponse invalide ou inutilisable. Le 504 signifie qu'il a cessé d'attendre. Le vérificateur affiche les deux sous la forme HTTP <code>.
Mon scraper rencontre parfois des erreurs 502. Dois-je changer de proxy ?
Des erreurs 502 occasionnelles signalent généralement un site cible surchargé plutôt qu'un proxy défaillant. Réduisez la cadence et ajoutez des retentatives espacées avant de remplacer quoi que ce soit.
Une erreur 502 venant d'un proxy est-elle identique à une 407 ?
Non. Une erreur 407 signifie que le proxy a refusé vos identifiants et n'a donc pas contacté le site. Une 502 signifie que le proxy vous a authentifié mais a échoué en joignant le site. Consultez 407 Proxy Authentication Required.
Une adresse que vous êtes le seul à utiliser
Une IPv4 dédiée ProxyV4 est attribuée à un seul client pendant toute la durée de location, évitant ainsi tout blocage causé par le trafic d'un autre utilisateur.
Voir les tarifs en temps réel