Il browser non riesce a decodificare la risposta. Confronta il corpo ricevuto con Content-Encoding e con la variante memorizzata in cache.
Indice dei contenuti
ERR_CONTENT_DECODING_FAILED: significato
Le prime ipotesi da verificare per “ERR_CONTENT_DECODING_FAILED” sono doppia compressione Gzip o Brotli; content-Encoding dichiarato ma corpo non compresso.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “ERR_CONTENT_DECODING_FAILED” compare durante un’operazione ripetibile.
- La funzione coinvolta in HTTP, browser e API non raggiunge il risultato previsto.
- Il log dell’area HTTP, browser e API registra un evento nello stesso minuto della prova.
- Il comportamento osservato in HTTP, browser e API cambia in base a utente, rete, file o configurazione.
Cause probabili
- Doppia compressione Gzip o Brotli
- Content-Encoding dichiarato ma corpo non compresso
- Cache che mescola varianti
- Proxy che decomprime senza aggiornare gli header
Diagnosi passo per passo
- Controllare Content-Encoding e Vary
- Svuotare la sola cache coinvolta
- Provare bypassando CDN
- Confrontare curl e browser
- Verificare integrità e dimensione della risposta
Log e dati da controllare
- DevTools, scheda Network
- log del server web o dell’applicazione
- log di proxy, CDN o WAF
Correzioni sicure
- Individua il livello che altera compressione o intestazioni, conservando prima una risposta di esempio.
- Allinea Content-Encoding al corpo effettivo e la cache alle varianti negoziate.
- Una ricompressione gestita correttamente dal proxy è possibile: evita la compressione duplicata non dichiarata, non ogni trasformazione.
- Svuota solo la cache coinvolta dopo la correzione e prova le varianti supportate.
Verifica finale
- La stessa richiesta riceve la risposta prevista
- Metodo, header e corpo sono coerenti
- Non compaiono redirect o tentativi inattesi
- I log confermano il medesimo esito
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- Brotli e Gzip: compressione web e controlli
- ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_DISPOSITION
- Errore 424 Failed Dependency: cause e soluzioni
Fonti tecniche
Domande frequenti
Che cosa significa “ERR_CONTENT_DECODING_FAILED”?
Il browser non riesce a decodificare la risposta. Confronta il corpo ricevuto con Content-Encoding e con la variante memorizzata in cache.
Da cosa può dipendere “ERR_CONTENT_DECODING_FAILED”?
Le cause da verificare per “ERR_CONTENT_DECODING_FAILED” sono: doppia compressione Gzip o Brotli; content-Encoding dichiarato ma corpo non compresso; cache che mescola varianti.
Quali controlli eseguire per “ERR_CONTENT_DECODING_FAILED”?
Individua il livello che altera compressione o intestazioni, conservando prima una risposta di esempio. Allinea Content-Encoding al corpo effettivo e la cache alle varianti negoziate. Una ricompressione gestita correttamente dal proxy è possibile: evita la compressione duplicata non dichiarata, non ogni trasformazione. Svuota solo la cache coinvolta dopo la correzione e prova le varianti supportate.