Co to znaczy
Serwer chwilowo nie może obsłużyć żądania z powodu przeciążenia lub konserwacji. Retry-After może podać, kiedy spróbować ponownie.
Typowe przyczyny
- Planowana konserwacja
- Serwer przeciążony lub bez wolnych workerów
- Autoskalowanie nie nadąża lub awarie zależności
Jak naprawić
Jako klient lub odwiedzający
Spróbuj później, respektując Retry-After.
Jako właściciel strony lub API
Wysyłaj Retry-After podczas konserwacji, zwiększaj pojemność i łagodnie odrzucaj nadmiar ruchu. Wyszukiwarki traktują krótkie 503 jako tymczasowe.
Przykładowa odpowiedź
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."
}Specyfikacja
FAQ
› Czy 503 nadaje się na strony konserwacji?
Tak. Zwróć 503 z Retry-After; wyszukiwarki zachowają wtedy stronę w indeksie, zamiast uznać ją za usuniętą.
› 503 czy 500?
503 mówi, że awaria jest tymczasowa i oczekuje się powrotu; 500 to nieoczekiwany błąd.