HTTP 500 Internal Server Error — Cause e soluzioni

Cosa significa HTTP 500

HTTP 500 Internal Server Error è la risposta generica “qualcosa è andato storto da parte nostra”. La richiesta ha raggiunto l'applicazione, l'applicazione ha fallito — un'eccezione non gestita, una configurazione errata, una dipendenza morta — e il server non aveva niente di meglio da dire.

Per i visitatori un 500 non è colpa loro e raramente è risolvibile dal browser. Per gli sviluppatori corrisponde sempre a una voce di log lato server; la soluzione inizia con la ricerca di quello stack trace.

Cause comuni degli errori 500

Un'eccezione non gestita nel codice dell'applicazione (riferimenti null, errori di tipo, asserzioni fallite).
Configurazione errata: direttive .htaccess o nginx rotte, permessi dei file sbagliati, variabili d'ambiente mancanti.
Una dipendenza morta o in timeout: database non raggiungibile, migrazioni mancanti, API esterna che fallisce senza fallback.
Esaurimento delle risorse: memoria esaurita, limiti PHP/worker, disco pieno.
Un deploy difettoso: pacchetti mancanti, versioni di librerie incompatibili, errori di sintassi nel codice in produzione.

Come risolverlo da visitatore

Ricarica una volta dopo una breve attesa — molti 500 sono blip transitori di deploy o sovraccarico.
Torna più tardi; il team del sito di solito lo sa prima ancora che tu possa segnalarlo.
Cancella i cookie solo se l'errore persiste specificamente per te e non per gli altri.

Come risolverlo da sviluppatore

Leggi il log degli errori del server — lo stack trace è la risposta (log errori nginx/apache, log applicazione, APM).
Prima di tutto, effettua il rollback dell'ultimo deploy se gli errori sono iniziati con esso.
Riproduci con la richiesta esatta che fallisce dai log di accesso; aggiungi error tracking (Sentry & co.) se non ne hai.
Non esporre mai gli stack trace agli utenti in produzione — registra i dettagli, mostra una pagina amichevole.

Esempio di risposta

HTTP/1.1 500 Internal Server Error
Content-Type: text/html

<!doctype html>
<title>Something went wrong</title>

Impatto SEO

I 500 persistenti fanno rallentare la scansione dei motori di ricerca e, se protratti per settimane, possono far uscire gli URL interessati dall'indice. Gli incidenti brevi sono innocui — Google riprova prima di decidere qualsiasi cosa.

FAQ

Un errore 500 è colpa mia come visitatore?

No. È un guasto lato server. Aspettare e ricaricare è praticamente tutto ciò che puoi fare.

Dove trovo cosa ha causato un 500?

Nel log degli errori del server o nel tuo servizio di error tracking — ogni 500 corrisponde a un'eccezione registrata o a un errore di configurazione.

Gli errori 500 influiscono sulla SEO?

Le interruzioni brevi no. Giorni o settimane di 500 riducono la scansione e possono far uscire temporaneamente le pagine dall'indice.