Cosa significa
Il server ha incontrato una condizione imprevista e non ha potuto completare la richiesta. È il codice generico per gli errori lato server.
Cause comuni
- Eccezione non gestita o bug nel codice dell'applicazione
- Configurazione errata, come un .htaccess sbagliato o una variabile d'ambiente mancante
- Guasto del database o di una dipendenza non mappato su uno stato più adatto
Come risolvere
Lato client o visitatore
Riprova più tardi; se persiste, segnalalo con l'orario e l'eventuale ID della richiesta presente nella risposta.
Lato gestore del sito o dell’API
Controlla i log di errore dell'applicazione e del server, correggi l'eccezione e restituisci codici più specifici (502, 503, 504) quando la causa è nota.
Risposta di esempio
HTTP/1.1
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Internal Server Error",
"status": 500,
"detail": "Something went wrong. Request id: 01J9Z6Q4K2."
}Specifica
Domande frequenti
› Come trovo la causa di un 500?
Cerca lo stack trace nel log degli errori del server o dell'applicazione all'ora della richiesta; attiva la modalità debug solo in sviluppo.
› Un file .htaccess può causare 500?
Sì. Un errore di sintassi o una direttiva sconosciuta in .htaccess fanno rispondere Apache con 500.