Cosa significa
Il server non è temporaneamente in grado di gestire la richiesta, per sovraccarico o manutenzione. Retry-After può dire quando riprovare.
Cause comuni
- Manutenzione programmata
- Server sovraccarico o senza worker liberi
- Autoscaling in ritardo o guasti delle dipendenze
Come risolvere
Lato client o visitatore
Riprova più tardi, rispettando Retry-After.
Lato gestore del sito o dell’API
Invia Retry-After durante la manutenzione, aumenta la capacità e scarta il carico con garbo. I motori di ricerca trattano i 503 brevi come temporanei.
Risposta di esempio
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."
}Specifica
Domande frequenti
› Il 503 va bene per le pagine di manutenzione?
Sì. Restituisci 503 con Retry-After; i motori mantengono la pagina indicizzata invece di considerarla rimossa.
› 503 o 500?
Il 503 dice che l'interruzione è temporanea e dovrebbe risolversi; il 500 è un guasto imprevisto.