Je klikt op een link of laadt een pagina, en in plaats van de site krijg je een foutmelding: 502 Bad Gateway. Geen uitleg, geen context, alleen die melding. Het lijkt alsof de server er is, maar ergens onderweg gaat er iets mis. En dat klopt ook.
Een 502 error betekent dat een server die als tussenstation fungeert (bijvoorbeeld een proxy of gateway), geen geldig antwoord krijgt van een andere server waar hij op vertrouwt. Die server kan bijvoorbeeld je backend zijn, een externe API of zelfs een database-interface. Het is dus geen front-endfout en ook geen crash in je eigen code, maar iets ertussenin.
Wat is een http 502 precies?
De http status code 502 valt onder de 5xx-reeks, oftewel: fouten aan serverzijde. Maar in tegenstelling tot een 500 internal server error, geeft 502 specifieker aan dat er communicatieproblemen zijn tussen servers onderling.
Stel je het internetverkeer voor als een doorgeefketen: browser → proxy → appserver. Als stap twee de bal doorgeeft aan stap drie, maar geen duidelijk antwoord terugkrijgt, dan zegt hij: “502, dit kan ik niet verwerken.”
Soms krijg je de fout te zien in de vorm van:
502 Bad Gateway
The server was acting as a gateway or proxy and received an invalid response from the upstream server.
Typische oorzaken van een 502 error
De fout kan worden veroorzaakt door:
- Een backendserver die down is of traag reageert
- Een verkeerde configuratie van je reverse proxy (bijv. NGINX of Apache)
- Een time-out in communicatie tussen servers
- DNS-problemen, vooral na recente wijzigingen in hosting
- Blokkades door firewalls of load balancers
- Externe API’s die niet goed bereikbaar zijn
Het lastige is dat het soms slechts tijdelijk is. Een zware piek in verkeer kan net genoeg zijn om een server kortstondig onbereikbaar te maken, waardoor de proxy geen geldig antwoord terugkrijgt. Maar als de fout aanhoudt, moet je echt gaan graven.
Heb je regelmatig last van dit soort meldingen op je WordPress-website? Dan is het verstandig om over te stappen naar een snellere en stabielere WordPress hosting oplossing.
Hoe vind je deze fout?
Als je website ineens een 502 meldingen geeft, kun je deze vaak ook terugvinden in tools zoals Screaming Frog. Tijdens het crawlen kan die tool precies aangeven welke URL’s een 502 status code teruggeven. Ook curl of Postman geven dit netjes terug in de response headers.
Bij JavaScript-gebaseerde apps of fetch-aanroepen zie je meldingen als:
request failed with status code 502
… of in combinatie met Axios:
axioserror: request failed with status code 502
Wat kun je eraan doen?
Een aantal technische checks:
- Herstart je backendservices. Als een proces vastloopt, kan een herstart wonderen doen.
- Check of de appserver reageert. Doe een directe request naar het backend endpoint, buiten de proxy om.
- Controleer je proxyconfiguratie. In NGINX: kloppen de proxy_pass-instellingen? Werkt de upstream?
- Log je foutdetails. Kijk in je serverlogs: NGINX’s error.log, PHP-FPM logs, of logs van je appframework.
- Test DNS-resolutie. Probeer het IP handmatig te resolven. Fouten ontstaan soms na migraties of DNS-wijzigingen.
- Firewall- of CDN-regels controleren. Vooral als je gebruikmaakt van Cloudflare of een andere caching-layer kunnen er blokkades ontstaan. Soms veroorzaakt Cloudflare zelfs een gerelateerde 520-fout bij onbekende problemen.
Slotgedachte
Een 502 http status code is frustrerend, omdat hij je niet veel uitleg geeft, alleen een symptoom. Maar achter dat symptoom schuilt een technisch communicatieprobleem. Tussenlagen zoals proxies, API-gateways of CDNs raken hun verbinding kwijt met een bronserver.
Zie een 502 error dus niet als het eindpunt, maar als een tussenmelding die je vertelt waar je moet zoeken: tussen frontend en backend. De bal wordt gespeeld, maar niemand vangt ’m op.
Een goed ingestelde monitoringstack, duidelijke logging en af en toe een Screaming Frog crawl helpen om dit soort fouten sneller te signaleren, en hopelijk op te lossen voor je gebruikers ze zien.
