Code HTTP 409 Conflict : signification et résolution

Bénin

Le code HTTP 409 Conflict indique que la requête du client est en conflit avec l'état actuel de la ressource cible sur le serveur. La requête est techniquement valide, mais elle contredit une contrainte existante (doublon, version obsolète, conflit de modification concurrente).

Que signifie le code 409 ?

Le code de statut HTTP 409 (Conflict), défini par la norme RFC 9110 (HTTP Semantics), appartient à la famille des codes 4xx : erreurs imputables au client. Il signale que la requête envoyée ne peut pas être traitée car elle est en conflit avec l'état actuel de la ressource cible. Contrairement au 400 (Bad Request), la requête est syntaxiquement correcte ; c'est sa sémantique qui crée un problème. Ce code est fréquent dans les API REST, les systèmes de versionnement de fichiers et les environnements WebDAV.

Causes probables

  • Tentative de création d'une ressource déjà existante (compte avec un identifiant déjà pris, enregistrement doublon en base de données).
  • Envoi d'une version d'un fichier plus ancienne que la version actuellement stockée sur le serveur (conflit de versionnement).
  • Opération WebDAV sur une collection (dossier) dont le dossier parent n'existe pas encore.
  • Modification concurrente d'une même ressource par deux clients simultanément (race condition).
  • Violation d'une contrainte d'unicité côté serveur ou en base de données (clé unique, index unique).

Comment résoudre le code 409

  1. Lire le corps de la réponse 409. La réponse 409 doit contenir des informations sur la nature du conflit (en JSON, XML ou texte). Lisez attentivement ce corps de réponse pour identifier précisément quelle contrainte est violée.
  2. Vérifier si la ressource existe déjà. Si vous tentez de créer une ressource (compte, fichier, enregistrement), vérifiez d'abord son inexistence avec une requête GET. Si elle existe déjà, utilisez PUT ou PATCH pour la mettre à jour plutôt que POST pour la créer.
  3. Mettre à jour votre version locale. Dans un contexte de versionnement (Git, WebDAV, API de gestion documentaire), récupérez la version la plus récente de la ressource depuis le serveur, fusionnez vos modifications, puis renvoyez la version résultante.
  4. Implémenter une gestion des conflits côté développeur. Pour les développeurs d'API : renvoyez un 409 avec un corps explicatif détaillant la contrainte violée. Côté client, implémentez une logique de retry précédée d'une lecture de l'état actuel (optimistic locking ou pattern check-then-act).

Quand faire appel à un professionnel

Pour les développeurs rencontrant un 409 persistant sur une API tierce, consultez la documentation de l'API concernée : le code 409 y est souvent documenté avec les champs de réponse permettant d'identifier le conflit.

Questions fréquentes

Quelle est la différence entre un code HTTP 409 et un code 400 ?
Le code 400 (Bad Request) indique une requête malformée ou invalide syntaxiquement. Le code 409 (Conflict) concerne une requête syntaxiquement correcte mais sémantiquement incompatible avec l'état courant de la ressource : les données sont valides, mais contradictoires avec ce que le serveur attend.
Un code 409 est-il une erreur côté client ou côté serveur ?
Le 409 appartient à la famille 4xx : c'est une erreur côté client. C'est la requête envoyée qui crée le conflit. Le client doit résoudre ce conflit (récupérer l'état actuel, mettre à jour sa version locale, etc.) avant de soumettre à nouveau la requête.
Le code 409 est-il temporaire ou permanent ?
Cela dépend de la cause. Un conflit de modification concurrente peut se résoudre en quelques instants une fois la ressource libérée. Un conflit d'unicité (identifiant déjà pris) est permanent tant que la ressource existante n'est pas supprimée ou modifiée.

Autres codes Serveur / HTTP

500Code d'erreur HTTP 500 Internal Server Error : signification et causes 403Code erreur HTTP 403 Forbidden : accès interdit, signification et solutions 502Code erreur HTTP 502 Bad Gateway : passerelle invalide, signification et solutions 503Code erreur HTTP 503 Service Unavailable : serveur indisponible, signification et solutions 400Code erreur HTTP 400 Bad Request : signification et solutions 404Code erreur 404 HTTP : signification, causes et que faire 401Code erreur HTTP 401 Unauthorized : signification et solution 504Code erreur HTTP 504 Gateway Timeout : signification et que faire 501Code erreur HTTP 501 Not Implemented : signification et solution 402Code erreur HTTP 402 Payment Required : signification 407Code HTTP 407 Proxy Authentication Required : signification et solution 408Code erreur HTTP 408 Request Timeout : signification et causes

Source : RFC 9110 - HTTP Semantics (IETF) · relevé le 10/08/2026.