HTTP 409 Conflict: Bedeutung und Behebung

Was dieser Fehler bedeutet und wie du ihn erkennst

• Ein Browser, API-Client, Monitoring-Tool oder eine Integration erhält eine Antwort HTTP 409 Conflict.
• Das Erstellen oder Aktualisieren einer Ressource schlägt fehl, während andere Seiten oder API-Routen weiterhin funktionieren.
• Der Fehler kann nur bei einer bestimmten HTTP-Methode auftreten, etwa POST, PUT oder PATCH.
• Das Wiederholen derselben Anfrage führt zum gleichen Konflikt, während eine Anfrage für eine andere Ressource erfolgreich ist.
• Der Antworttext kann auf eine bereits vorhandene Ressource, eine veraltete Version, einen doppelten Wert, einen Statusübergang oder eine Anwendungsregel hinweisen.
• DNS kann weiterhin aufgelöst werden und TLS kann weiterhin erfolgreich sein, weil die Anfrage einen HTTP-fähigen Endpunkt erreicht hat; dabei handelt es sich um separate Prüfungen.

Hauptursachen nach Wahrscheinlichkeit

1. Eine Ressource ist bereits vorhanden oder ein eindeutiger Wert wird doppelt verwendet. Eine Erstellungsoperation kann mit einem vorhandenen Datensatz, Benutzernamen, Bezeichner, Dateinamen oder einem anderen eindeutig beschränkten Wert kollidieren.
2. Eine gleichzeitige oder veraltete Aktualisierung. Die Ressource kann geändert worden sein, seit der Client sie zuletzt gelesen hat. Dadurch stimmt die übermittelte Version nicht mehr mit dem aktuellen Zustand überein.
3. Ein ungültiger Statusübergang. Die Anwendung kann eine Operation ablehnen, die im aktuellen Zustand der Ressource nicht zulässig ist, etwa die Änderung eines abgeschlossenen, archivierten oder gesperrten Elements.
4. Anwendungs- oder Webserverregeln. Routenlogik, Validierung, Anfragerichtlinien oder eine eigene Fehlerbehandlung können für einen bekannten Konflikt bewusst 409 zurückgeben.
5. Verhalten von Proxy, CDN oder WAF. Ein Zwischenserver kann die Antwort aufgrund von Routing, Caching, Anfrageprüfung oder einer Upstream-Konfiguration erzeugen oder verändern.
6. Umgebungsspezifische Regeln für Authentifizierung oder Autorisierung. Manche Anwendungen verwenden 409 für einen Konflikt beim Konto- oder Ressourcenstatus, obwohl Authentifizierungsfehler häufiger andere Statuscodes verwenden. Bestätigen Sie das Verhalten anhand der Antwort und der Protokolle, statt die Quelle des Statuscodes anzunehmen.

So behebst du den Fehler

Zuerst die Anfrage bestätigen

1. Notieren Sie die genaue URL, HTTP-Methode, den Anfrage-Body, den authentifizierten Benutzer- oder Client-Kontext, den Zeitpunkt und den endgültigen Statuscode.
2. Prüfen Sie Antwort-Header und Antworttext auf eine Konflikt-ID, den Speicherort der Ressource, Versionsinformationen, den Cache-Status, einen Proxy-Hinweis oder eine Fehlermeldung der Anwendung.
3. Bestätigen Sie, ob Weiterleitungen stattgefunden haben und ob der 409 vom endgültigen Endpunkt oder von einem Zwischenserver stammt.
4. Ändern Sie die Konfiguration erst, wenn Sie wissen, ob die Antwort für diese Route und Methode beabsichtigt ist.

Wenn Sie Besucher oder API-Nutzer sind

1. Überprüfen Sie die URL, das ausgewählte Konto oder die Ressource sowie die übermittelten Daten.
2. Prüfen Sie vor einer erneuten Übermittlung, ob die Ressource bereits existiert, wenn die Operation eine Ressource erstellt.
3. Wenn die Operation eine Ressource aktualisiert, rufen Sie die aktuelle Version neu ab und wiederholen Sie die Anfrage nur über den von der Anwendung unterstützten Aktualisierungsablauf.
4. Melden Sie sich über den normalen Kontozugriff an, wenn die Ressource eine Authentifizierung erfordert. Übermitteln Sie Passwörter oder Tokens nicht an eine nicht vertrauenswürdige Seite.
5. Vermeiden Sie wiederholte Versuche, wenn die Antwort auf ein Duplikat, einen gesperrten Zustand oder ein serverseitiges Limit hinweist.
6. Wenn der Konflikt bestehen bleibt, übermitteln Sie dem Websitebetreiber oder API-Anbieter den Endpunkt, die Methode, den Zeitpunkt, den Antworttext und eine bereinigte Anfrage-ID. Entfernen Sie Passwörter, Cookies, API-Schlüssel und personenbezogene Daten.

Wenn Sie die Website oder API betreuen

1. Reproduzieren Sie das Problem mit derselben Methode, URL, denselben Anfragedaten und demselben Konto- oder Client-Kontext. Verwenden Sie eine Test- oder Staging-Umgebung, wenn die Operation Daten verändert.
2. Ermitteln Sie, welche Komponente die Antwort erzeugt hat: Anwendung, Webserver, Reverse Proxy, CDN oder WAF. Vergleichen Sie, sofern verfügbar, Antwort-Header, Serversignaturen und Anfrage-IDs.
3. Durchsuchen Sie die passenden Protokolle dieser Komponente und ordnen Sie Zeitpunkt, Route, Methode, Benutzer- oder Client-ID sowie die Upstream-Antwort einander zu.
4. Prüfen Sie bei Erstellungsoperationen doppelte Werte oder Einschränkungen für eindeutige Felder. Prüfen Sie bei Aktualisierungen das Optimistic Locking sowie Versions-, ETag- oder andere von der Anwendung verwendete Daten zur Nebenläufigkeit.
5. Überprüfen Sie den aktuellen Zustand der Ressource und die zulässigen Statusübergänge der Anwendung. Umgehen Sie einen Konflikt nicht einfach durch das Löschen oder Überschreiben von Daten, sofern diese Aktion nicht autorisiert und verstanden ist.
6. Vergleichen Sie kürzlich erfolgte Deployments und Änderungen an Routing, Validierung, Authentifizierung, Caching, Proxy- und WAF-Regeln.
7. Wenden Sie die engste dokumentierte Korrektur an. Testen Sie anschließend dieselbe Anfrage sowie eine normale Anfrage für verwandte Routen erneut. Bestätigen Sie, dass Antworttext, Header und Statuscode nun dem gewünschten Verhalten entsprechen.
8. Wenn der 409 beabsichtigt ist, machen Sie die Antwort umsetzbar, indem Sie den Konflikt erklären und gegebenenfalls angeben, wie der Client den Zustand aktualisieren, einen anderen Wert wählen oder den Statuskonflikt beheben kann.

Vorbeugung und Überprüfung der Lösung

• Dokumentieren Sie, welche Operationen bewusst 409 zurückgeben können und wie Clients anschließend vorgehen sollen.
• Verwenden Sie in API-Antworten klare Meldungen zu Duplikaten, veralteten Versionen und ungültigen Statuswerten.
• Testen Sie Abläufe zum Erstellen, Aktualisieren und gleichzeitigen Aktualisieren nach Anwendungs-Releases.
• Halten Sie die Konfiguration für Routing, Proxy, Authentifizierung, Caching und WAF versionskontrolliert.
• Überwachen Sie Statuscodes nach Route und HTTP-Methode, statt alle 409-Antworten als ein einziges Problem zu behandeln.
• Bewahren Sie Anwendungs- und Infrastrukturprotokolle lange genug auf, um Konflikte mit Deployments und Konfigurationsänderungen abgleichen zu können.
• Verwenden Sie eine dokumentierte Strategie für Nebenläufigkeit, etwa die von der Anwendung unterstützte Versionierung oder Methode für bedingte Aktualisierungen.

Häufig gestellte Fragen