Il codice di stato HTTP 204 No Content non è un errore. Significa che la richiesta è andata a buon fine e il server non ha nulla da restituire. Molti lo scoprono aprendo gli strumenti per sviluppatori del browser e vedendolo comparire accanto a richieste di statistiche, salvataggi automatici o chiamate di plugin, e si chiedono se ci sia qualcosa che non va. Nella grande maggioranza dei casi la risposta è no: il 204 è uno dei segnali più comuni di un sito che funziona correttamente, e compare decine di volte durante una normale navigazione. In alcune situazioni particolari, però, un 204 nel posto sbagliato può nascondere un problema reale.
In questa guida vediamo che cosa significa il 204, dove lo incontri normalmente, come distinguerlo dagli altri codici di successo e in quali casi merita attenzione.
Cosa significa il codice 204
Il 204 appartiene ai codici 2xx, quelli di successo, descritti nella guida ai codici di stato HTTP. Come il più comune 200 OK, comunica che il server ha ricevuto, compreso ed eseguito la richiesta. La differenza è che con il 204 il server dichiara esplicitamente di non inviare alcun contenuto nel corpo della risposta: niente pagina, niente dati, solo le intestazioni.
È una risposta pensata per le operazioni in cui il client non ha bisogno di ricevere nulla, se non la conferma che tutto è andato bene. Inviare una pagina o un messaggio in quei casi sarebbe uno spreco di banda e di tempo.
Dove incontri il 204 nella pratica
Statistiche e tracciamento. Gli strumenti di analisi del traffico inviano al proprio server piccole richieste ogni volta che una pagina viene vista o un pulsante viene cliccato. Il server registra il dato e risponde 204: non c’è nulla da mostrare all’utente. Se apri la scheda Rete degli strumenti per sviluppatori su quasi qualsiasi sito, vedrai diverse richieste di questo tipo.
Salvataggi in background. Molte applicazioni web salvano i dati mentre lavori senza ricaricare la pagina: una bozza, una preferenza, la posizione di un elemento. Il server conferma il salvataggio con un 204 e la pagina resta com’è.
API e operazioni di modifica. Nelle API, il 204 è la risposta tipica a operazioni come la cancellazione di un elemento o l’aggiornamento di un dato quando non serve restituire il risultato. Una richiesta DELETE andata a buon fine, per esempio, risponde spesso con un 204.
Controlli di connettività. Molti sistemi operativi verificano se il dispositivo è davvero connesso a Internet interrogando un indirizzo che risponde sempre 204. Se ricevono un 204, la connessione funziona; se ricevono qualcos’altro, per esempio la pagina di accesso di un Wi-Fi pubblico, capiscono che c’è un portale da superare e lo aprono automaticamente. È il meccanismo che fa comparire la pagina di login quando ti colleghi alla rete di un albergo.
Richieste preliminari dei browser. Quando una pagina chiama un’API su un dominio diverso, il browser invia prima una richiesta di verifica con il metodo OPTIONS per controllare che l’operazione sia consentita. Molti server rispondono con un 204, a cui seguono le intestazioni con i permessi.
204, 200 e 205 a confronto
Il 200 OK indica successo e, di norma, include un contenuto: la pagina, i dati richiesti, un messaggio di conferma. Il 204 No Content indica successo senza contenuto, e il browser non deve cambiare la pagina che sta mostrando. Esiste anche il 205 Reset Content, poco usato, che indica successo senza contenuto e chiede al client di reimpostare la vista, per esempio svuotando un modulo appena inviato.
Per le pagine web vere e proprie, quelle che i visitatori leggono e che i motori di ricerca indicizzano, la risposta corretta è sempre 200. Il 204 è adatto solo alle richieste di servizio che avvengono dietro le quinte.
Come vedere i codici 204 sul tuo sito
Apri il sito nel browser, premi F12 per aprire gli strumenti per sviluppatori e vai nella scheda Rete. Ricarica la pagina e interagisci con essa: nella colonna Stato vedrai il codice di ogni richiesta. Puoi filtrare per tipo, per esempio mostrando solo le richieste di tipo Fetch/XHR, che sono quelle tipiche delle chiamate in background. Da terminale, il comando curl -I seguito da un indirizzo mostra il codice restituito da quella specifica risorsa.
Su WordPress noterai spesso richieste verso admin-ajax.php o verso indirizzi che contengono wp-json: sono le chiamate interne dell’editor, dei plugin e del sistema di salvataggio automatico. Alcune rispondono 200 con dei dati, altre 204 senza contenuto: entrambe le risposte indicano che tutto funziona.
Quando il 204 indica un problema
Ci sono però alcune situazioni in cui un 204 merita di essere indagato.
Una pagina vera che risponde 204. Se un indirizzo che dovrebbe mostrare una pagina restituisce 204, il visitatore vedrà una pagina bianca o il browser resterà sulla pagina precedente, senza alcun messaggio di errore. Per un motore di ricerca, una pagina che risponde 204 non ha contenuto da indicizzare. Succede raramente, di solito per un errore di configurazione di un plugin di cache, di una regola del server o di un’applicazione che restituisce il codice sbagliato.
Un modulo che “non fa niente”. Se premi il pulsante di invio di un modulo e non succede nulla, e negli strumenti per sviluppatori vedi una risposta 204, il server ha accettato la richiesta ma non ha restituito il messaggio di conferma che il sito si aspettava di mostrare. A volte è normale, se la conferma viene gestita dal codice della pagina; altre volte indica che l’invio è stato scartato in silenzio, per esempio da un filtro antispam.
Statistiche che non registrano. Al contrario, se le richieste verso lo strumento di analisi non rispondono 204 ma vengono bloccate o restituiscono errori, i dati di traffico saranno incompleti. Il blocco può dipendere da estensioni dei visitatori, da un banner per il consenso ai cookie configurato male o da regole del server.
Il 204 nelle API: perché gli sviluppatori lo usano
Se lavori con un’API o con un’integrazione, capire perché uno sviluppatore sceglie il 204 aiuta a interpretare le risposte. Immagina un’app che gestisce gli indirizzi di spedizione di un cliente. Quando l’app chiede l’elenco degli indirizzi, il server risponde 200 con i dati. Quando l’app crea un nuovo indirizzo, il server risponde di solito 201 Created, spesso con i dati dell’indirizzo appena creato. Quando l’app cancella un indirizzo, il server risponde 204: l’operazione è riuscita e non c’è nulla da restituire, perché l’elemento non esiste più.
Questa convenzione permette al programma che riceve la risposta di sapere che non deve aspettarsi dati. Se uno script si aspetta un contenuto e riceve un 204, o viceversa, può comportarsi in modo imprevisto: per esempio mostrare un messaggio di errore anche se l’operazione è andata a buon fine, perché prova a leggere dati che non esistono. Quando un’integrazione segnala errori strani dopo un’operazione riuscita, controllare il codice di stato restituito è uno dei primi passi.
Per chi gestisce un sito senza scrivere codice, la regola pratica è semplice: un 204 su una richiesta di servizio è un segnale di salute, non di guasto. Se qualcosa non funziona, la causa va cercata altrove, per esempio in un errore 400 o in un errore del server registrato poco prima o poco dopo.
Il 204 e la cache
Un dettaglio tecnico utile: le risposte 204 possono essere memorizzate dalla cache del browser o di un CDN, se le intestazioni lo consentono. Per le richieste di servizio questo raramente crea problemi, ma se per errore una pagina vera risponde 204 e quella risposta viene memorizzata in cache, il problema può persistere per i visitatori anche dopo che hai corretto la causa. In questi casi, dopo la correzione, svuota la cache del plugin, del server e del CDN.
Il codice 204 e la SEO
Per la SEO, le risposte 204 delle richieste di servizio sono irrilevanti: Google non indicizza le chiamate di statistiche o i salvataggi in background. L’unico caso da evitare è quello di pagine pubbliche che rispondono 204, perché Google non trova nulla da indicizzare e, nel tempo, le esclude dai risultati. Se nel rapporto sull’indicizzazione di Search Console compaiono pagine importanti con problemi di contenuto vuoto, verifica con gli strumenti per sviluppatori quale codice restituiscono.
Domande frequenti
Devo preoccuparmi se vedo molti 204 negli strumenti per sviluppatori?
No. Le richieste di statistiche, salvataggio e verifica rispondono normalmente 204. Diventa rilevante solo se a rispondere 204 è l’indirizzo di una pagina che dovrebbe mostrare dei contenuti.
Il 204 compare nei log del server: è un errore?
No, nei log il 204 indica richieste andate a buon fine senza contenuto. Se però vedi molti 204 su indirizzi di pagine pubbliche, verifica la configurazione del sito. Per interpretare le righe dei log, consulta la guida ai log del server.
Perché il mio telefono contatta indirizzi che rispondono 204?
Per verificare che la connessione a Internet funzioni davvero. Se la risposta non è il 204 atteso, il sistema capisce che c’è un portale di accesso, come quello di un Wi-Fi pubblico, e te lo mostra.
