De HTTP-statuscode 502 Bad Gateway treedt op wanneer een server die fungeert als gateway of proxy een ongeldig of onbegrijpelijk antwoord heeft ontvangen van een upstream server. Er is dus wel een antwoord ontvangen, maar het klopt niet.
502 Bad Gateway – De gateway ontving een ongeldig antwoord van de upstream server.
Oorzaken van een 502-fout
- De upstream server (bijv. een applicatieserver of PHP-FPM) is gecrasht of herstart
- De upstream server stuurt een ongeldig of corrupt HTTP-antwoord terug
- Netwerkstoringen tussen de gateway en de upstream server
- De upstream server is overbelast en geeft een onverwachte foutrespons
Verschil tussen 502 en 504
| Code | Naam | Wat is er misgegaan? |
|---|---|---|
| 502 | Bad Gateway | De upstream server stuurde een ongeldig antwoord terug. |
| 504 | Gateway Timeout | De upstream server stuurde helemaal geen antwoord terug (te laat). |
Hoe los je een 502-fout op?
- Als bezoeker: Wacht een moment en laad de pagina opnieuw. De fout is vaak tijdelijk.
- Als beheerder: Controleer de status van de upstream server (bijv. PHP-FPM, Node.js, of een microservice).
- Bekijk de serverlogs voor foutmeldingen van de upstream service.
- Herstart de upstream service indien nodig.
- Controleer de netwerkconfiguratie en firewallregels tussen de servers.
Samenvatting
Een HTTP 502 Bad Gateway-fout wijst op een communicatieprobleem tussen twee servers. De gateway ontving een antwoord, maar kon er niets mee. Controleer de status en logs van de upstream server om de oorzaak te achterhalen.