HTTP 409 Conflict
Codice di stato 409 · Classe 4xx
Messaggio ufficiale (come appare sullo schermo): Conflict
Cercato anche come: error 409, HTTP 409, 409 conflict
Che cosa significa
La richiesta non può essere completata perché è in conflitto con lo stato attuale della risorsa. Le API restituiscono 409 quando provi a creare qualcosa che esiste già, ad aggiornare un record modificato da qualcun altro o a eseguire un'azione non consentita nello stato corrente.
Si applica a: API REST, WebDAV, API di hosting Git
Come risolvere HTTP 409 Conflict
- Aggiorna i dati e ripeti la modifica partendo dalla versione più recente
- Leggi il corpo della risposta: le API ben progettate spiegano quale campo o versione è in conflitto
- Se stai creando una risorsa, verifica che non esista già (nome utente, email o ID duplicati)
- Se l'API usa gli ETag, invia il valore corrente in 'If-Match' e riprova dopo aver recuperato l'ultima copia
- Per i client di sincronizzazione file o WebDAV, risolvi manualmente la copia in conflitto
- Se gestisci l'API: restituisci un messaggio di errore chiaro e la versione corrente della risorsa, così i client possono recuperare
Perché succede
La RFC 9110 usa il 409 per i conflitti con lo stato corrente della risorsa di destinazione, tipicamente modifiche concorrenti, vincoli di unicità e transizioni di stato non valide.
Domande frequenti
Il 409 è un errore del server?
No. È un codice 4xx lato client: la richiesta è valida, ma si scontra con i dati esistenti e va modificata o ripetuta.
Errori correlati
Fonte: IANA HTTP Status Code Registry · soluzioni scritte e verificate dalla redazione (vedi la nostra politica editoriale)
Ultimo aggiornamento: