Ga naar de inhoud
StealthRDP
VPS-beheer

502 Bad Gateway: wat het betekent en hoe je het oplost

502 Bad Gateway betekent dat een server een ongeldig antwoord krijgt van de server erachter. Uitleg voor bezoekers en beheerders: nginx, PHP-FPM, Cloudflare.

Gepubliceerd op

9 min. leestijd

502 Bad Gateway betekent dat een server die als gateway of proxy optreedt, een ongeldig antwoord heeft gekregen van de server daarachter. De fout zit tussen twee servers in en komt dus niet van de browser of het apparaat van de bezoeker. [1] [2]

Deze gids bestaat uit twee delen. Ben je bezoeker, dan lees je in het korte deel hieronder wat je kunt proberen. Beheer je de site, dan zoek je in het deel over de oplossing uit welke schakel de 502 teruggaf, lees je de logregel die de oorzaak noemt en loop je de oplossing door, met tips om herhaling te voorkomen.

Wat betekent 502 Bad Gateway?

Een verzoek aan een website gaat vaak via meerdere schakels:

browser → CDN or proxy → web server → application

Elke schakel stuurt het verzoek door naar de volgende. Krijgt een proxy van de schakel erachter een antwoord waar hij niets mee kan, dan stuurt de proxy een 502 terug. Welke schakel faalde, staat niet in de statuscode. In nginx verschijnt een 502 ook als de upstream de verbinding weigert, reset of te vroeg sluit. De code zegt je dus alleen dat de verbinding achter de proxy is misgegaan.

Wat een 502 niet is: het is geen melding dat de bezoeker een ongeldig verzoek heeft gestuurd, en het is ook geen time-out. Een trage upstream geeft een andere code; die komt in het volgende deel aan bod.

502 vs 503 vs 504

De meeste fouten aan de serverkant tussen twee schakels vallen onder drie codes. Ze wijzen op verschillende oorzaken, dus kijk eerst goed naar de code voordat je begint te zoeken.

Code Wat er gebeurde Gebruikelijke oorzaak Wat je eerst controleert
502 Bad Gateway De gateway kreeg een ongeldig antwoord van de upstream-server [1] [2] De app draait niet, weigerde de verbinding, crashte midden in het verzoek of stuurde headers die nginx niet accepteert De regel in het errorlog van nginx voor dat verzoek
503 Service Unavailable De server kan het verzoek tijdelijk niet afhandelen [1] Overbelasting of gepland onderhoud De belasting van de server en of er werkzaamheden aan de gang zijn
504 Gateway Timeout De gateway kreeg niet op tijd antwoord van de upstream-server [1] [3] De upstream is te traag, bijvoorbeeld door een lange databasequery, en de time-out van de proxy is verlopen [4] Welk verzoek traag is en wat de app doet tijdens het wachten

Een 504 is een timingprobleem: de upstream antwoordde te laat, niet verkeerd. In nginx staan de time-outs voor het lezen van het antwoord, bij zowel proxy als FastCGI, standaard op 60 seconden [4] [5].

Een hogere time-out lost een 502 niet op

Time-outs zoals proxy_read_timeout en fastcgi_read_timeout bepalen alleen hoe lang nginx op een antwoord wacht. Een 502 betekent dat het antwoord ongeldig was, ontbrak of nooit is aangekomen. Een hogere time-out verandert daar niets aan. Pas time-outs alleen aan als de fout een 504 is.

Zie je als bezoeker een 502?

De server kun je niet repareren, maar je kunt wel uitsluiten dat het aan jouw kant ligt en het probleem melden.

  • Wacht een minuut en laad de pagina opnieuw. Een herstart of een deploy op de server kan de fout vanzelf laten verdwijnen.
  • Probeer een andere browser of een ander netwerk, zoals mobiele data. Laadt de site daar wel, dan ligt het probleem bij je eigen verbinding.
  • Kijk op de statuspagina van de site, als die er een heeft.
  • Noteer het tijdstip en het exacte adres dat je opende. Die gegevens heeft de eigenaar van de site nodig om de bijbehorende logregel te vinden.

Het probleem moet meestal op de server worden opgelost, dus alleen de eigenaar van de site kan de fout verhelpen. Is de site van jou, volg dan de stappen hieronder.

502 Bad Gateway oplossen op je server

Werk van buiten naar binnen. Elke stap sluit één schakel uit voordat je naar de volgende gaat.

1. Zoek uit welke server de 502 teruggaf

Vraag de pagina twee keer op. Het eerste verzoek gaat via de openbare route. Het tweede maakt rechtstreeks verbinding met het IP-adres van je originserver (de server waarop de site echt draait) en stuurt de naam van de site mee in de Host-header. Vervang het voorbeeldadres door je eigen adres.

Shell
curl -I "https://www.example.com/"
curl -I --resolve www.example.com:443:203.0.113.10 "https://www.example.com/"

Bekijk bij elk antwoord de statusregel en de headers:

  • Een cf-ray-header en server: cloudflare betekenen dat het antwoord via Cloudflare liep. Ze staan er ook als de 502 van je originserver kwam, dus ze vertellen je niet welke kant faalde; dat zie je aan de pagina zelf (zie het deel over Cloudflare hieronder).
  • Een header server: nginx bij het directe verzoek betekent dat nginx op je originserver de 502 heeft teruggegeven.

Krijg je ook bij het directe verzoek een 502, dan ligt de oorzaak bij de originserver: ga verder met stap 2. Krijg je bij het directe verzoek een 200 en bij het openbare verzoek een 502, dan zit de fout in de route vóór de originserver. Beoordeel dan de pagina zelf zoals beschreven in het deel over Cloudflare hieronder, en loop stap 7 na.

2. Lees het errorlog

Krijgt nginx geen bruikbaar antwoord van de upstream, dan schrijft het de reden naar zijn errorlog. Bekijk de laatste regels:

Shell
sudo tail -n 50 /var/log/nginx/error.log

Zo vind je bij elke melding de oorzaak:

Logregel (bevat) Gebruikelijke oorzaak Wat je doet
connect() failed (111: Connection refused) while connecting to upstream De app draait niet of luistert op een andere poort Start de app of corrigeer de poort (stap 3)
connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory) Verkeerd socketpad, of PHP-FPM is gestopt Controleer het socketpad en de dienst (stap 3 en 4)
connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied) Door de eigenaar of de rechten (mode) van de socket kan nginx geen verbinding maken Controleer de instellingen listen.owner, listen.group en listen.mode in de PHP-FPM-pool
upstream prematurely closed connection while reading response header from upstream De app is tijdens het verzoek gecrasht of beëindigd, vaak omdat het geheugen op was Controleer het geheugen en de crashlogs (stap 5)
upstream sent too big header while reading response header from upstream De headers van het antwoord zijn groter dan de buffer van nginx Vergroot de buffer (stap 6)
no live upstreams while connecting to upstream Elke server in het upstream-blok is als niet beschikbaar gemarkeerd Controleer de servers in het blok en daarna de app achter elke server (stap 3)

De logregel noemt het adres of de socket van de upstream. Vergelijk dat met waar de app werkelijk op luistert.

3. Controleer of de app draait

Controleer de dienst en de poort of socket waarop die luistert. Kies het tabblad dat bij je stack past.

sudo systemctl status php8.3-fpm
sudo ss -lxp | grep php
pm2 status
sudo ss -ltnp | grep 3000
sudo systemctl status gunicorn
sudo ss -ltnp | grep 8000

Draai je Node onder systemd, gebruik dan systemctl status <service> in plaats van pm2 status. Is de dienst gestopt, lees dan eerst de logs en herstart hem pas daarna, zodat de reden van de crash niet verloren gaat. De logs lees je bijvoorbeeld met sudo journalctl -u php8.3-fpm -n 100.

4. Controleer of proxy_pass of fastcgi_pass overeenkomt met de app

Het adres in nginx moet overeenkomen met de poort of socket uit stap 3. Klopt dat niet, dan krijg je de regels met “Connection refused” of “No such file or directory” uit stap 2.

Voor een reverse proxy naar een app op een lokale poort:

/etc/nginx/sites-available/example.conf
location / {
    proxy_pass http://127.0.0.1:3000;
}

Voor PHP-FPM via een Unix-socket:

/etc/nginx/sites-available/example.conf
location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

Test de configuratie en herlaad nginx daarna. Mislukt de test, dan wordt nginx niet herladen en blijft de huidige, werkende configuratie actief.

Shell
sudo nginx -t && sudo systemctl reload nginx

5. Controleer geheugen en crashes

De regel upstream prematurely closed connection wijst op een proces dat midden in een verzoek is afgebroken. Op een kleine VPS is de gebruikelijke oorzaak de out-of-memory killer van de kernel. Doorzoek het kernellog:

Shell
sudo dmesg -T | grep -i -E "out of memory|killed process"
free -h

Gebruik je PHP-FPM, zoek dan in het errorlog van PHP-FPM naar server reached pm.max_children setting. Die melding betekent dat alle workerprocessen bezig zijn. Elk workerproces gebruikt RAM, dus verhoog pm.max_children pas als je hebt gecontroleerd dat de server genoeg geheugen vrij heeft voor de extra processen [6].

Heeft de server gewoon te weinig geheugen voor de site, dan is de oplossing een groter pakket, geen langere time-out. In veelvoorkomende prestatieknelpunten op een VPS lees je hoe je geheugentekort herkent aan vertragingen.

6. Los 502’s door te grote headers op

Staat in het log upstream sent too big header, dan zijn de headers in het antwoord van de upstream groter dan de buffer van nginx. Vergroot de buffer voor dat location-blok. De waarden hieronder zijn voorbeelden; stem ze af op je grootste header.

/etc/nginx/sites-available/example.conf
location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_buffer_size 16k;
    proxy_buffers 8 16k;
}

Gebruik bij PHP-FPM op dezelfde manier fastcgi_buffer_size en fastcgi_buffers in het location-blok met fastcgi_pass [5]. De standaardwaarden van de directives en hun precieze syntaxis vind je in de modulereferentie [4]. Je kunt ook de headers die de app stuurt kleiner maken, bijvoorbeeld door te grote cookies aan te pakken. Test en herlaad daarna zoals in stap 4.

7. Controleer de firewall tussen de proxy en de originserver

Draait een proxy op een andere host, of maakt een dienst als Cloudflare verbinding met je originserver, dan kan een firewallregel die verbinding blokkeren. De proxy krijgt dan geen bruikbaar antwoord en geeft een 502 terug. Controleer of de originserver verbindingen accepteert van de adressen van de proxy, op de poort die daarvoor wordt gebruikt. Op Ubuntu met ufw:

Shell
sudo ufw status verbose

Gebruik je een andere firewall, controleer dan de regels daarvan.

Een 502 achter Cloudflare

Aan de inhoud van de pagina zie je welke kant de fout veroorzaakte. Volgens Cloudflare komt een 502- of 504-pagina met Cloudflare-branding van de webserver op je originserver. Een kale pagina zonder Cloudflare-branding kan van Cloudflare komen, maar Cloudflare noemt ook een compressieprobleem op de originserver als oorzaak van 502’s zonder branding [7]. De branding geeft dus in de meeste gevallen uitsluitsel, maar niet in alle. Heeft de pagina geen branding en antwoordt de originserver bij een direct verzoek met 200, controleer dan de compressie-instellingen van de originserver.

Is een 502 slecht voor je SEO?

Een korte 502 kan weinig kwaad. Volgens de documentatie van Google over zijn crawlers gaan die langzamer crawlen bij 5xx- en 429-antwoorden. URL’s die steeds serverfouten blijven geven, verdwijnen uiteindelijk uit de index, al blijven geïndexeerde URL’s er in het begin nog in staan. Zodra de server opnieuw 2xx-antwoorden geeft, gaat het crawlen weer sneller [8].

In de praktijk betekent dat: los de oorzaak snel op. Een fout die lang aanhoudt, kan je posities in de zoekresultaten kosten.

502-fouten voorkomen

  • Monitor de site van buitenaf. Een externe controle laat je weten wanneer de 502 begint, in plaats van dat een bezoeker het later meldt. Zie tools voor uptime-monitoring.
  • Zorg voor genoeg RAM. Processen die door geheugentekort worden beëindigd, veroorzaken de regels met “prematurely closed connection”. Raakt het geheugen van de server regelmatig op, lees dan signalen dat je VPS meer resources nodig heeft en veelvoorkomende problemen met VPS-hosting en hun oplossingen.
  • Laat de app herstarten als die uitvalt. Een systemd-unit met een herstartbeleid start de app na een crash opnieuw. Restart=on-failure herstart het proces alleen als het met een fout stopt. De bug die de crash veroorzaakte, is daarmee niet opgelost, dus bewaar de logregels uit stap 2.
/etc/systemd/system/myapp.service
[Service]
ExecStart=/usr/bin/node /srv/myapp/server.js
Restart=on-failure
RestartSec=5
  • Voeg een healthcheck toe. Geef de app een endpoint dat alleen 200 teruggeeft als de app verzoeken kan afhandelen, en monitor dat endpoint. Een proces dat wel draait maar vastzit, zie je dan ook als storing.
  • Weet waar je moet kijken als de server stopt. Reageert de server uit zichzelf niet meer, lees dan waarom een server zomaar stopt.

Bereid je voor op de volgende storing

Noteer vóór een incident de poort of socket waarop de app luistert, het pad naar het log en het commando om de app te herstarten. De oplossing in stap 2 hangt af van de exacte logregel, en voor een snel herstel moet je de naam van de dienst kennen.

De fout zelf oplossen op een VPS van StealthRDP

Bij de Linux-pakketten van StealthRDP krijg je volledige root-toegang, dus je draait de webserver en de applicatie zelf en kunt elke stap uit deze gids op je eigen server uitvoeren. Pakketten vergelijken doe je via Linux VPS en VPS-pakketten.

Bronnen en referenties
  1. RFC 9110: HTTP Semantics — RFC Editor (IETF) (geraadpleegd op 2026-10-10)
  2. 502 Bad Gateway — MDN Web Docs (Mozilla) (geraadpleegd op 2026-10-10)
  3. 504 Gateway Timeout — MDN Web Docs (Mozilla) (geraadpleegd op 2026-10-10)
  4. Module ngx_http_proxy_module — nginx (geraadpleegd op 2026-10-10)
  5. Module ngx_http_fastcgi_module — nginx (geraadpleegd op 2026-10-10)
  6. PHP: Configuration (FPM) — The PHP Group (geraadpleegd op 2026-10-10)
  7. Error 502 or 504 — Cloudflare (geraadpleegd op 2026-10-10)
  8. How HTTP Status Codes Affect Google's Crawlers — Google (geraadpleegd op 2026-10-10)

Lees verder