HTTP-fout 502
502 Bad Gateway: wat het betekent en hoe u het oplost
Het korte antwoord
De voordeur antwoordde, maar de kamer erachter niet. Uw webserver of CDN vroeg PHP of uw applicatie om een pagina en kreeg niets bruikbaars terug.
- Back-up vóór elke wijziging
- Vaste prijs vooraf
- Op afstand, overal ter wereld
- Gratis diagnose
Bij elke 502 horen twee partijen: de gateway die u de fout toont en de upstream die faalde. Eerst moet u weten welke schakel brak, en het foutenlogboek van de gateway vertelt dat meestal. “connect() failed (111: Connection refused) while connecting to upstream” wijst op een gestopt PHP-proces. “upstream prematurely closed connection” betekent dat het halverwege een verzoek stierf.
Herkenbaar?
Symptomen van een 502 Bad Gateway
- Een pagina met “502 Bad Gateway”
- De Apache-melding: “The proxy server received an invalid response from an upstream server”
- Een Cloudflare-pagina met “Bad gateway, Error code 502”
- De fout komt en gaat: weg na opnieuw laden, terug op drukke momenten
- Het begon na een deployment, een herstart van de server, een verhuizing of een drukte
Oorzaken
Waarom krijgt u een 502 Bad Gateway?
Het applicatieproces is gecrasht of gestopt
PHP-FPM (het proces dat PHP draait voor nginx), Node of Gunicorn is gestopt of herstart. De webserver heeft dan niets meer om mee te praten. Dit is de meest voorkomende oorzaak.
Een te zwaar verzoek
Een script dat al zijn geheugen opeet of tegen een procesgrens aanloopt, wordt halverwege afgebroken. De gateway ziet een kapot antwoord en meldt een 502.
Proxy of CDN bereikt uw server niet
Cloudflare of een load balancer wijst naar het verkeerde IP-adres van uw server, bijvoorbeeld na een verhuizing, of uw server accepteert de verbindingen niet.
Server overbelast
Als alle PHP-workers bezet zijn, mislukken nieuwe verzoeken. PHP-FPM logt dan “server reached pm.max_children setting”.
Een foute plugin, thema of release
Code die het PHP-proces zelf laat crashen, in plaats van alleen een fout te geven, komt als 502 naar buiten in plaats van als 500.
Een firewall of limiet
Een firewall of beveiligingsmodule die de IP-adressen van de proxy blokkeert, breekt de verbinding af, ook als de site zelf gezond is.
Zelf proberen
502 Bad Gateway zelf aanpakken: eerste stappen
Deze controles zijn veilig. Doe ze in volgorde en stop zodra de site weer werkt.
- 1 Wacht een minuut, laad opnieuw en test een andere pagina en een ander netwerk. Een 502 die onder druk komt en gaat is een ander probleem dan een die blijft.
- 2 Gebruikt u Cloudflare of een andere CDN, zet die dan kort uit (of op alleen DNS) en laad opnieuw. Laadt de site nu, dan is uw server in orde en zit het in de proxy-instellingen of een firewall. Blijft het falen, dan ligt het aan de server. Zet de CDN daarna weer aan.
- 3 Controleer of PHP draait. Herstart PHP of de app in uw hostingpaneel; op uw eigen server draait u systemctl status php-fpm (de servicenaam bevat meestal de versie, zoals php8.3-fpm).
- 4 Lees de logs: het nginx error.log en het PHP-FPM-log. “Connection refused” betekent dat de upstream plat ligt, “upstream timed out” dat hij te traag was en “server reached pm.max_children” dat hij overbelast is.
- 5 Hernoem op WordPress wp-content/plugins naar plugins-uit om een plugin uit te sluiten. Begon de 502 na een PHP-upgrade, ga dan in uw hostingpaneel terug naar de vorige PHP-versie.
- 6 Verhuisde u onlangs naar een andere server of wijzigde u nameservers? Controleer dan of het IP-adres van de server in Cloudflare overeenkomt met dat van uw hostingpartij.
Onze aanpak
Zo verhelpen wij een 502 Bad Gateway
-
1
We zoeken de falende schakel
We volgen het verzoek van gateway tot applicatie aan de hand van de proxy- en PHP-logs, zodat we weten welke schakel brak, en niet alleen dát er een brak.
-
2
Back-up vóór elke wijziging
Eerst een volledige kopie van bestanden en database, zodat elke wijziging ongedaan te maken is.
-
3
Oorzaak, vaste prijs, uw akkoord
De diagnose is gratis. U krijgt de oorzaak in gewone taal, een vaste prijs en een tijdsinschatting. Zonder uw akkoord begint er niets.
-
4
Herstellen, belasting testen en rapporteren
We herstellen de oorzaak, controleren of de site normaal verkeer aankan en sturen een kort rapport over wat er mis was en wat we wijzigden.
Wat we nodig hebben
Wat wij van u nodig hebben
- Toegang tot uw hostingpaneel of SSH, inclusief de nginx/Apache- en PHP-logs
- Toegang tot Cloudflare of uw CDN, als u die gebruikt
- Een beheerderslogin voor uw CMS of applicatie, als dat er is
- Wanneer de 502 begon, of hij constant is of af en toe, en wat er eerder veranderde
We vragen de minimale toegang die nodig is, gebruiken per klant een aparte sleutel en u kunt die intrekken zodra we klaar zijn.
Wat wij niet kunnen oplossen
Een 502 die zijn oorsprong heeft in het eigen netwerk van uw hostingpartij, of op een beheerd platform waar we geen servertoegang krijgen, kunnen we niet oplossen. Is dat de oorzaak, dan zeggen we dat na de gratis diagnose, met het bewijs dat u bij uw leverancier kunt aanleveren.
Prijs
Prijs en wat er daarna gebeurt
-
1
Gratis diagnose
We zoeken de oorzaak en vertellen u wat er mis is.
-
2
Vaste prijs
U krijgt een prijs en een tijdsinschatting. Zonder uw ja begint er niets.
-
3
Opgelost en gerapporteerd
We herstellen het, testen het en sturen een kort verslag.
Vanaf €295 excl. btw
Vaste prijs, afgesproken voordat we beginnen
Is het dringend? Zeg het in het formulier of in de chat. We beginnen zo snel als we kunnen en geven u bij de offerte een realistische tijdsinschatting. Kost voorrang extra, dan ziet u dat in de offerte voordat u akkoord gaat.
Laat het oplossenVragen?
Vragen over de 502 Bad Gateway-fout
Ook bekeken
Gerelateerde problemen
Website niet bereikbaar
Een website is niet bereikbaar als de server uw pagina’s niet meer aan bezoekers kan leveren. De meest voorkomende oorzaken, op volgorde van...
Lees meer →Website gehackt
Een gehackte website is een site waarin iemand anders zonder uw toestemming code, bestanden of beheerdersaccounts heeft geplaatst. Typische...
Lees meer →Laatst bijgewerkt:
Aanvraag
Vertel ons wat er mis is
Beantwoord een paar korte vragen. U krijgt een vaste prijs voordat we iets doen.
Bedankt voor uw aanvraag!
We nemen spoedig contact met u op
Er is een fout opgetreden!
Probeer het alstublieft opnieuw.