HTTP 503 Service Unavailable

Der Server kann die Anfrage vorübergehend nicht bearbeiten – er ist überlastet oder wird gewartet. Häufig wird die Meldung „Retry-After“ angezeigt.

Definiert in RFC 9110 §15.6.4 — 503 Service Unavailable · MDN-Referenz

Wo Ihnen HTTP 503 in der Praxis begegnet

Geplante Wartung, ein laufendes Deployment, eine ausgefallene Abhängigkeit oder ein Load Shedder, der Verkehr absichtlich abweist, um den Rest zu schützen.

Warum Sie ihn testen sollten

Anders als ein 500 ist ein 503 ausdrücklich wiederholbar. Testen Sie, dass Ihr Client beide unterschiedlich behandelt, statt sie zu einem „Fehler“ zusammenzufassen.

Was Ihr Client bei einem 503 tun sollte

Versuchen Sie es mit Backoff erneut und berücksichtigen Sie die Retry-After-Anfrage des Servers. Ein 503-Fehler mit Retry-After-Anfrage signalisiert dem Server genau, wann er zurückkehren soll; wird diese Anfrage ignoriert, wird ein sich erholender Dienst wieder aktiviert. Führen Sie bei nicht unbedingt notwendigen Aufrufen einen Fehlerbehandlungs- oder Deaktivierungsvorgang durch.

503 und die Codes, mit denen er verwechselt wird

Endpunkte, die 503 zurückgeben

7 Endpunkte dieses Playgrounds antworten mit 503. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

Fragen zu HTTP 503

Sollen Wartungsseiten den Statuscode 503 erhalten?
Ja. Eine mit 200 ausgelieferte Wartungsseite sagt Suchmaschinen, dass diese dünne Seite der eigentliche Inhalt ist.
Wie lange soll ich warten?
So lange, wie Retry-After angibt. Ohne den Header: exponentielles Backoff mit Jitter und einer Gesamtfrist.

Weitere Server-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert