502 Bad Gateway betekent dat een server die als gateway of proxy optreedt een ongeldige response heeft ontvangen van de upstreamserver die hij benaderde om het verzoek uit te voeren. De proxy zelf werkt; het probleem zit erachter.
In een typische opzet is de proxy nginx, Apache, een load balancer of een CDN, en is de upstream een applicatieserver zoals PHP-FPM, Node.js, Gunicorn of een container. Onder “ongeldige response” vallen een geweigerde of verbroken verbinding, een crash midden in een response, misvormde headers, of headers die groter zijn dan de buffers van de proxy (nginx logt dan “upstream sent too big header”).
Bij Cloudflare leveren problemen met de oorspronkelijke server meestal specifiekere codes op, zoals 520, 521 of 522. Een gewone 502 via Cloudflare kan van de oorspronkelijke server zelf komen of van een probleem binnen het netwerk van Cloudflare.
Voorbeeldresponse
HTTP/1.1 502 Bad Gateway
Date: Fri, 06 Nov 2026 10:15:32 GMT
Server: nginx
Content-Type: text/html
Content-Length: 142
Connection: keep-alive
<html>
<head><title>502 Bad Gateway</title></head>
<body>
<center><h1>502 Bad Gateway</h1></center>
<hr><center>nginx</center>
</body>
</html>SEO en redirects controleren
Net als bij andere 5xx-fouten vertragen korte periodes met 502’s het crawlen zonder dat pagina’s verdwijnen, terwijl aanhoudende 502’s tot verwijdering uit de index leiden. 502’s komen vaak met tussenpozen voor (een worker die herstart, een pool die volloopt), dus controleer een URL meerdere keren of gebruik de Bulk-redirectchecker om te zien hoe vaak het misgaat.
Veelvoorkomende oorzaken en toepassingen
- De applicatieserver (PHP-FPM, Node.js, Gunicorn) is uitgevallen, wordt herstart of is gecrasht.
- De proxy wijst naar het verkeerde upstreamadres, de verkeerde poort of de verkeerde socket.
- De responseheaders van de upstream zijn groter dan de buffers van de proxy (
proxy_buffer_sizeoffastcgi_buffer_sizein nginx). - Een firewall of security group verhindert dat de proxy de backend bereikt.