DevToolPal
NL
5xx Serverfouten

502 Bad Gateway

Ongeldige gateway

Wat het betekent

Een gateway of proxy kreeg een ongeldig antwoord van de upstream-server waarnaar hij het verzoek doorstuurde.

Veelvoorkomende oorzaken

  • De appserver is gecrasht of luistert niet (verkeerde poort of socket)
  • Upstream sloot de verbinding of stuurde misvormde headers
  • Herstart van PHP-FPM-, Gunicorn- of Node-processen

Zo los je het op

Als client of bezoeker

Probeer het zo opnieuw; meestal is het tijdelijk. Blijft het, dan ligt de backend van de site plat.

Als beheerder van de site of API

Controleer of het upstream-proces draait en luistert op het adres dat de proxy gebruikt, en lees het foutlog van de proxy voor de exacte upstream-fout.

Voorbeeldantwoord

HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0

Specificatie

RFC 9110 §15.6.3

Veelgestelde vragen

› Hoe los ik 502 Bad Gateway op in nginx?

Controleer de upstream (draait de app, klopt het proxy_pass-adres of de socket) en het nginx-foutlog; herstart de appserver als die is gecrasht.

› 502 of 504?

502: upstream antwoordde onzin of sloot de verbinding. 504: upstream antwoordde niet op tijd.