Come risolvere errori HTTP 500, 502 e 503

Gli errori 5xx indicano un guasto lato server, ma ogni codice punta a un livello di errore diverso. Questa guida aiuta a isolare rapidamente il livello corretto.

Triage rapido (primi 5 minuti)

1. Esegui l'URL in Verifica siti web per registrare stato e tempi di risposta.
2. Verifica se il problema riguarda un solo percorso URL o tutti gli endpoint.
3. Controlla se l'errore è stabile o intermittente.
4. Correla con deploy, modifiche di configurazione o picchi di traffico.

500 Internal Server Error

Un errore generico di app/server. Cause più comuni: eccezione applicativa non gestita, variabile d'ambiente errata, problema di permessi o chiamata a dipendenza fallita.

• Esamina prima i log dell'applicazione, poi quelli del web server.
• Controlla release e migrazioni recenti.
• Verifica permessi dei file e segreti di runtime.

502 Bad Gateway

Di solito un problema di proxy/gateway tra Nginx/Apache/load balancer e la tua app upstream.

• Conferma che il processo upstream sia in esecuzione e in ascolto sull'host/porta previsti.
• Controlla timeout del proxy e disallineamenti keepalive.
• Valida il DNS upstream nei deployment containerizzati.

503 Service Unavailable

Servizio temporaneamente non disponibile, spesso per sovraccarico, modalità manutenzione o pool di worker esauriti.

• Ispeziona saturazione di CPU, memoria e pool di connessioni.
• Controlla eventi di autoscaling e rate limiting.
• Verifica flag di manutenzione o health check configurati male.

Cosa includere nelle escalation al supporto

• URL + codice di stato esatto
• Timestamp del primo rilevamento (preferibilmente UTC)
• Se il problema è globale o specifico di una regione
• Eventuali deploy recenti o modifiche all'infrastruttura

Per errori lato DNS, consulta la nostra guida alla propagazione DNS. Per errori di mismatch del nome host del certificato, consulta questa guida SSL.