HTTP Status Code Error 504 – Wat is het?

Heb je ooit een webpagina bezocht en een foutmelding gekregen met de tekst “504 Gateway Timeout”? Dan ben je niet de enige. Dit is een veelvoorkomende HTTP-foutcode die aangeeft dat er iets misgaat in de communicatie tussen servers. In dit artikel leggen we uit wat een 504-fout precies is, hoe hij ontstaat en wat je eraan kunt doen.

Wat is een HTTP 504-fout?

Een HTTP 504 Gateway Timeout-fout is een serverstatusscode die aangeeft dat een server die fungeert als gateway of proxy, geen tijdig antwoord heeft ontvangen van een upstream server waaraan hij een verzoek heeft doorgestuurd.

Simpel gezegd: Server A vraagt iets aan Server B, maar Server B reageert niet snel genoeg. Server A geeft dan een 504-fout terug aan de bezoeker.

504 Gateway Timeout – De server heeft niet tijdig een reactie ontvangen van een andere server die hij nodig had om het verzoek te voltooien.

Hoe verschilt een 504 van andere foutcodes?

Er zijn meerdere serverfouten in de 5xx-reeks. Hier is een kort overzicht van de meest voorkomende:

Wat zijn de oorzaken van een 504-fout?

Een 504-fout kan door meerdere oorzaken worden veroorzaakt. De meest voorkomende zijn:

• Trage upstream server: De webapplicatieserver, databaseserver of API reageert te langzaam of helemaal niet.
• Overbelasting van de server: De server heeft te veel verzoeken tegelijkertijd en kan ze niet snel genoeg verwerken.
• Netwerk- of firewallproblemen: De communicatie tussen servers wordt geblokkeerd of vertraagd door netwerkproblemen.
• DNS-problemen: Een onjuiste of verouderde DNS-configuratie kan ervoor zorgen dat verzoeken niet op de juiste server aankomen.
• Te korte timeout-instellingen: De gateway is geconfigureerd met een te korte wachttijd, waardoor een verzoek al als “verlopen” wordt beschouwd voordat de upstream server kan reageren.
• Fouten in de webapplicatie: Een script of applicatie die te lang draait (bijv. een zware database-query) kan een timeout veroorzaken.

Hoe los je een 504-fout op?

De oplossing hangt af van of je de fout tegenkomt als bezoeker of als beheerder/ontwikkelaar van een website.

Als bezoeker

1. Wacht even en probeer opnieuw. De fout is vaak tijdelijk. Vernieuw de pagina na 30–60 seconden.
2. Controleer je internetverbinding. Zorg dat je zelf een stabiele verbinding hebt.
3. Leeg je browsercache. Een verouderde cache kan soms problemen veroorzaken.
4. Probeer een andere browser of apparaat. Hiermee sluit je lokale problemen uit.
5. Controleer de statuspagina van de website. Veel diensten hebben een statuspagina (bijv. status.voorbeeld.nl) waar storingen worden gemeld.

Als beheerder of ontwikkelaar

1. Controleer de serverlogs. Bekijk de foutlogs van je webserver (Nginx, Apache) en applicatieserver om de exacte oorzaak te achterhalen.
2. Verhoog de timeout-waarden. Pas de proxy_read_timeout (Nginx) of ProxyTimeout (Apache) aan als de upstream server meer tijd nodig heeft.
3. Controleer de status van upstream services. Is je databaseserver, API of microservice bereikbaar en reageert deze snel genoeg?
4. Optimaliseer trage processen. Zware database-queries of slecht geoptimaliseerde scripts kunnen de oorzaak zijn. Profiel en optimaliseer deze.
5. Controleer firewall- en beveiligingsinstellingen. Zorg dat de communicatie tussen de gateway en upstream server niet wordt geblokkeerd.
6. Schaal de servercapaciteit op. Bij structurele overbelasting kan het nodig zijn om extra servercapaciteit toe te voegen of load balancing in te stellen.

Samenvatting

Een HTTP 504 Gateway Timeout-fout treedt op wanneer een tussenliggende server (gateway of proxy) niet op tijd een reactie ontvangt van een upstream server. De fout ligt altijd aan de serverkant en is in de meeste gevallen tijdelijk of verhelpenbaar. Als bezoeker is geduld en een herlaadpoging vaak voldoende. Als beheerder is het zaak om serverlogs te raadplegen, timeout-instellingen te controleren en eventuele bottlenecks in de infrastructuur te identificeren.