Il 406 riguarda normalmente il formato della risposta richiesto dal client. Controlla Accept; Content-Type descrive invece il contenuto inviato.
Indice dei contenuti
Errore 406 Not Acceptable: significato
Accept richiede un formato che l’endpoint non produce. Il server sceglie di non fornire una rappresentazione alternativa. Un WAF usa 406 per bloccare la richiesta: va confermato nel log.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “errore 406 Not Acceptable” 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
- Accept richiede un formato che l’endpoint non produce.
- Il server sceglie di non fornire una rappresentazione alternativa.
- Un WAF usa 406 per bloccare la richiesta: va confermato nel log.
Diagnosi passo per passo
- Salvare header di richiesta e risposta
- Provare Accept application/json o text/html
- Confrontare browser e client API
- Controllare l’ID della regola di sicurezza
- Verificare il punto esatto del codice che genera la risposta
Log e dati da controllare
- DevTools, scheda Network
- log del server web o dell’applicazione
- log di proxy, CDN o WAF
Correzioni sicure
- Confronta i formati accettati dal client con quelli prodotti dall’endpoint.
- Correggi Accept o il formato della risposta secondo la documentazione API.
- Se il codice è emesso dal WAF, verifica evento e regola: applica un’esclusione solo dopo aver confermato il falso positivo.
- Non cambiare il corpo della richiesta alla cieca per superare il filtro.
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
- HTTP 205 Reset Content: risposta inattesa
- Errore 406 Not Acceptable: WAF e contenuti
- Errore 205 Reset Content: significato e soluzioni
Fonti tecniche
Domande frequenti
Che cosa significa “Errore 406 Not Acceptable”?
Il 406 riguarda normalmente il formato della risposta richiesto dal client. Controlla Accept; Content-Type descrive invece il contenuto inviato.
Da cosa può dipendere “Errore 406 Not Acceptable”?
Accept richiede un formato che l’endpoint non produce. Il server sceglie di non fornire una rappresentazione alternativa. Un WAF usa 406 per bloccare la richiesta: va confermato nel log.
Quali controlli eseguire per “Errore 406 Not Acceptable”?
Confronta i formati accettati dal client con quelli prodotti dall’endpoint. Correggi Accept o il formato della risposta secondo la documentazione API. Se il codice è emesso dal WAF, verifica evento e regola: applica un’esclusione solo dopo aver confermato il falso positivo. Non cambiare il corpo della richiesta alla cieca per superare il filtro.