L’API comprende la richiesta ma rifiuta i dati con 422. Leggi il dettaglio di validazione per capire quale campo o vincolo correggere.
Indice dei contenuti
Errore 422 Unprocessable Content: significato
Le prime ipotesi da verificare per “Errore 422 Unprocessable Content” sono campo obbligatorio mancante o vuoto; valore formalmente valido ma fuori dominio.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “errore 422 Unprocessable Content” 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
- Campo obbligatorio mancante o vuoto
- Valore formalmente valido ma fuori dominio
- Relazione tra risorse non consentita
- Stato dell’oggetto incompatibile con l’azione
Diagnosi passo per passo
- Salvare la risposta di validazione completa
- Confrontare payload con lo schema corrente
- Provare un campo alla volta su dati di test
- Verificare stato e permessi delle risorse collegate
- Controllare versione del client e dell’endpoint
Log e dati da controllare
- DevTools, scheda Network
- log del server web o dell’applicazione
- log di proxy, CDN o WAF
Correzioni sicure
- Confronta risposta completa e schema della versione API utilizzata.
- Correggi i valori indicati usando dati di test e preservando gli altri campi.
- Gestisci nel client il messaggio utile all’utente, senza esporre dati sensibili.
- Verifica il risultato applicativo dopo la correzione; ritentare lo stesso payload senza modifiche non risolve la validazione.
Verifica finale
- I dati validi vengono accettati e gli input non validi restano rifiutati.
- Confronta il risultato con la prova iniziale e conserva gli eventuali errori rimasti.
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
- Errore 422 Unprocessable Content: validazione API
- Errore 205 Reset Content: significato e soluzioni
- HTTP 204 No Content con corpo inatteso
Fonti tecniche
Domande frequenti
Che cosa significa “Errore 422 Unprocessable Content”?
L’API comprende la richiesta ma rifiuta i dati con 422. Leggi il dettaglio di validazione per capire quale campo o vincolo correggere.
Da cosa può dipendere “Errore 422 Unprocessable Content”?
Le cause da verificare per “Errore 422 Unprocessable Content” sono: campo obbligatorio mancante o vuoto; valore formalmente valido ma fuori dominio; relazione tra risorse non consentita.
Quali controlli eseguire per “Errore 422 Unprocessable Content”?
Confronta risposta completa e schema della versione API utilizzata. Correggi i valori indicati usando dati di test e preservando gli altri campi. Gestisci nel client il messaggio utile all’utente, senza esporre dati sensibili. Verifica il risultato applicativo dopo la correzione; ritentare lo stesso payload senza modifiche non risolve la validazione.