Bedeutung
Der Server kann die Anfrage vorübergehend nicht bearbeiten, wegen Überlastung oder Wartung. Retry-After kann angeben, wann es erneut versucht werden soll.
Typische Ursachen
- Geplante Wartung
- Server überlastet oder ohne freie Worker
- Autoscaling kommt nicht nach oder Abhängigkeiten sind ausgefallen
So beheben Sie es
Als Client oder Besucher
Später erneut versuchen und Retry-After beachten.
Als Betreiber der Website oder API
Während der Wartung Retry-After senden, Kapazität erhöhen und Last kontrolliert abwerfen. Suchmaschinen behandeln kurze 503 als vorübergehend.
Beispielantwort
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}Spezifikation
FAQ
› Eignet sich 503 für Wartungsseiten?
Ja. 503 mit Retry-After zurückgeben; Suchmaschinen behalten die Seite dann im Index, statt sie als entfernt zu werten.
› 503 oder 500?
503 sagt, dass der Ausfall vorübergehend ist und sich erholen soll; 500 ist ein unerwarteter Fehler.