tool::http-status-detail
504 Gateway Timeout
The gateway did not receive a timely response from an upstream server.
Statuscode
504
Name
Gateway Timeout
Kategorie
5xxDetaillierte Erklärung
HTTP 504 Gateway Timeout zeigt an, dass ein Gateway- oder Proxyserver innerhalb des Timeout-Fensters keine Antwort vom Upstream-Server erhalten hat. Im Gegensatz zu 502 (fehlerhafte Antwort) bedeutet 504, dass gar keine Antwort angekommen ist. Es tritt häufig auf, wenn eine langsame Datenbankabfrage oder ein externer API-Aufruf die Antwort des Upstream-Servers verzögert.
Häufige Ursachen
- ▸Der Upstream-Server reagiert aufgrund einer langsamen Datenbankabfrage verzögert
- ▸Die Upstream-Verarbeitungszeit übersteigt das konfigurierte Proxy-Timeout
- ▸Der Upstream-Server ist überlastet und antwortet langsam
- ▸Ein externer API-Aufruf blockiert die gesamte Anfrage-Pipeline
- ▸Netzwerküberlastung verzögert die Paketübertragung zwischen Servern
Lösungsansätze
- 1.Erhöhen Sie die Werte für proxy_read_timeout und proxy_connect_timeout in Nginx
- 2.Optimieren Sie langsame Datenbankabfragen (Ausführungspläne analysieren)
- 3.Überprüfen Sie die Last des Upstream-Servers und erwägen Sie ein Scale-out
- 4.Wenden Sie Timeout- und Circuit-Breaker-Muster auf externe API-Aufrufe an
- 5.Lagern Sie lang laufende Aufgaben in asynchrone Queues und Worker-Prozesse aus
Zugehörige HTTP-Header
Retry-AfterServerAntwortbeispiel
HTTP/1.1 504 Gateway Timeout Server: nginx/1.24.0 Content-Type: text/html <html><body><h1>504 Gateway Timeout</h1><p>The upstream server did not respond in time.</p></body></html>
Verwandte Statuscodes
500Internal Server ErrorThe server encountered an unexpected condition.→501Not ImplementedThe server does not support the requested functionality.→502Bad GatewayThe gateway received an invalid response from an upstream server.→503Service UnavailableThe server is temporarily unable to handle the request.→505HTTP Version Not SupportedThe HTTP version used in the request is not supported.→
ad · 300×250
// related tools