Spezifikation von dem HTTP statuscode 409

Der Statuscode 409 Conflict zeigt an, dass die Anfrage aufgrund eines Konflikts mit dem aktuellen Zustand der Zielressource nicht abgeschlossen werden konnte. Dieser Code wird in Situationen verwendet, in denen der Benutzer in der Lage sein könnte, den Konflikt zu lösen und die Anfrage erneut zu übermitteln. Der Server SOLLTE eine Nutzlast generieren, die genügend Informationen enthält, damit ein Benutzer die Quelle des Konflikts erkennen kann.

Konflikte treten am ehesten als Antwort auf eine PUT-Anfrage auf. Wenn zum Beispiel Versionierung verwendet wird und die Darstellung, die PUT ist, Änderungen an einer Ressource enthält, die mit denen einer früheren (fremden) Anfrage in Konflikt stehen, könnte der Ursprungsserver eine 409 Conflict-Antwort verwenden, um anzuzeigen, dass er die Anfrage nicht abschließen kann. In diesem Fall würde die Antwortdarstellung wahrscheinlich Informationen enthalten, die für die Zusammenführung der Unterschiede auf der Grundlage des Revisionsverlaufs nützlich sind.

Quelle / Zitat von: Spezifiziert wird der 409 Conflict HTTP Status Code durch Abschnitt 6.5.8 von RFC7231

HTTP-Protokoll

Wie kann man mit PHP einen 409-Statuscode werfen?

Um auf einer Webseite den HTTP Status Code 409 zu werfen, kann die PHP Funktion http_response_code benutzt werden. Die Syntax sieht wie folgt aus: http_response_code(409) (PHP 5 >= 5.4.0, PHP 7, PHP 8)

Teste den 409 HTTP Status Code

http-statuscode.com (Test Statuscode 409)

httpstat.us (Test Statuscode 409)

Um die HTTP Status Code (in diesem Fall 409 Conflict) und weitere Informationen clientseitig anzeigen zu können, muss die Entwicklungskonsole mit F12 geöffnet werden. Im Anschluss muss zu der Karteikarte "Netzwerk" navigiert werden. Jetzt kann die Seite geöffnet werden, im Netzwerktab sollte die Webseite (Beispiel index.php) zu sehen sein. Diese muss ausgewählt werden und im Anschluss der Bereich Herder gewählt werden. Hier sieht der Nutzer dann folgendes Ergebnis:

Überblick
URL: https://http-statuscode.com/errorCodeExample.php?code=409
Status: 409 Conflict
Diese: Network
IP-Adresse: XX.XX.XX.XX

Wie löse ich das Problem mit dem 409 Statuscode?

Der 409 Conflict Conflict Statuscode zeigt an, dass die Anforderung, die vom Client gesendet wurde, in Konflikt mit dem aktuellen Zustand der Zielressource steht. Dies kann beispielsweise passieren, wenn zwei Clients gleichzeitig versuchen, die gleiche Ressource zu aktualisieren.

Ursachen für den 409 Conflict Conflict Statuscode

Gleichzeitige Updates: Wie bereits erwähnt, ist eine häufige Ursache für einen 409 Conflict-Statuscode der Versuch mehrerer Clients, eine Ressource gleichzeitig zu ändern.
Inkonsistente Daten: Wenn ein Client Daten sendet, die nicht den erwarteten Formatierungs- oder Validierungsregeln des Servers entsprechen, kann ein 409 Conflict-Statuscode zurückgegeben werden.
Logische Konflikte: Selbst wenn Daten korrekt formatiert sind, können logische Konflikte auftreten. Ein Beispiel wäre ein Reservierungssystem, bei dem zwei Personen versuchen, den gleichen Sitzplatz zur gleichen Zeit zu buchen.

Schritte zur Behebung des 409 Conflict Conflict Statuscodes:

Datenvalidierung: Stellen Sie sicher, dass die vom Client gesendeten Daten korrekt formatiert und konsistent sind. Überprüfen Sie die vom Server bereitgestellten Validierungsregeln und passen Sie Ihre Anfrage entsprechend an.
Implementierung von Locking-Mechanismen: Für Systeme, bei denen die Möglichkeit gleichzeitiger Updates besteht, kann ein Locking-Mechanismus nützlich sein. Dies verhindert, dass mehr als ein Benutzer gleichzeitig Änderungen an einer Ressource vornimmt.
Implementierung von Versionskontrollen: Indem jeder Zustand einer Ressource mit einer Version gekennzeichnet wird, können Clients sicherstellen, dass sie immer mit der aktuellen Version arbeiten.
Feedback an den Benutzer: Wenn ein 409 Conflict-Konflikt auftritt, sollte der Client mit einer klaren und verständlichen Fehlermeldung informiert werden, damit er weiß, wie er weiter vorgehen soll.
Server-Logs überprüfen: Oftmals enthalten Server-Logs zusätzliche Informationen über die Ursache des Konflikts. Das Durchsuchen dieser Logs kann Aufschluss darüber geben, welches Problem genau vorliegt.
Retry-Logik: In einigen Fällen kann es sinnvoll sein, die Anfrage automatisch erneut zu senden, insbesondere wenn der Konflikt durch kurzfristige Bedingungen verursacht wird, die sich schnell ändern können.

Wie erstellt man eine eigene Fehlerseite für den Statuscode 409

Eine eigene 409 Conflict Fehlerseite zu erstellen ist sowohl mit dem Webserver "Apache" als auch mit dem Webserver "NGINX", relativ leicht.

Apache Webserver

Der Webserver "Apache" gilt zu den meist verbreitetsten Webservern im Internet. Um einen eigene 409 Conflict Fehlerseite in"Apache" zu erstellen, muss in folgender Datei folgende Änderung durchgeführt werden.

File: .htaccess

ErrorDocument 409 /errors/409.html

NGINX Webserver

Ähnlich wie der Webserver "Apache" ist auch "NGINX" im Internet weit verbreitet. Um einen eigene 409 Conflict Fehlerseite in "NGINX" zu erstellen, muss in folgender Datei folgende Änderung durchgeführt werden.

File: sites-enabled/default

error_page 409 /409.html;
location = /409.html {
root /usr/share/nginx/html;
internal;
}

Browser-Kompatibilität des 409 Statuscode

Chrome	no data
Edge	no data
Firefox	no data
Opera	no data
Safari	no data
Chrome Android	no data
Firefox for Android	no data
Opera Android	no data
Safari on iOS	no data
Internet	no data
WebView Android	no data