Ein http 409 Statuscode wird angezeigt, wenn eine Anfrage aufgrund eines Konflikts mit dem aktuellen Zustand der Zielressource nicht abgeschlossen werden kann. Dies tritt oft auf, wenn der Benutzer den Konflikt möglicherweise beheben und die Anfrage erneut stellen kann.
Der Server SOLLTE eine Nutzlast generieren, die genügend Informationen enthält, damit der Benutzer die Quelle des Konflikts erkennen kann. [1]
Konflikte treten meist bei PUT-Anfragen auf. Ein Beispiel wäre, wenn Versionierung verwendet wird und die durch PUT übermittelte Repräsentation Änderungen an einer Ressource enthält, die mit vorherigen (durch Dritte vorgenommenen) Änderungen im Konflikt stehen. In diesem Fall könnte der Ursprungsserver einen 409-Fehlercode verwenden, um anzuzeigen, dass die Anfrage nicht abgeschlossen werden kann. Die Antwort würde dann wahrscheinlich Informationen enthalten, die für das Zusammenführen der Unterschiede auf der Grundlage der Versionshistorie nützlich sind.
Quelle: RFC7231 Abschnitt 6.5.8
409 CODE REFERENZEN:
- Rails: HTTP Status Symbol:
:conflict - Go: HTTP Status Konstante:
http.StatusConflict - Symfony: HTTP Status Konstante:
Response::HTTP_CONFLICT - Python2: HTTP Status Konstante:
httplib.CONFLICT - Python3+: HTTP Status Konstante:
http.client.CONFLICT - Python3.5+: HTTP Status Konstante:
http.HTTPStatus.CONFLICT - .NET: HttpStatusCode:
Conflict - Rust:
http::StatusCode::CONFLICT - Java:
java.net.HttpURLConnection.HTTP_CONFLICT - Apache HttpComponents Core:
org.apache.hc.core5.http.HttpStatus.SC_CONFLICT - Angular:
@angular/common/http/HttpStatusCode.Conflict
Beispiel für 409 Statuscode:
Anfrage:
bashCode kopierenPUT /api/users/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{
"name": "John Smith",
"email": "john@example.com",
"password": "newpassword"
}
Antwort:
cssCode kopierenHTTP/1.1 409 Conflict
Content-Type: application/json
Content-Length: 42
{
"error": "User with ID 123 already exists"
}
In diesem Beispiel versucht die Anfrage, einen Benutzer mit der ID 123 zu aktualisieren. Der Server antwortet jedoch mit einem 409 Konfliktstatuscode, da ein Benutzer mit dieser ID bereits existiert. Die Antwort enthält eine JSON-Fehlermeldung, die den Grund des Konflikts angibt.
So beheben Sie einen http 409 Statuscode
- Ursache des Konflikts identifizieren: Die Fehlermeldung, die mit dem 409-Statuscode zurückgegeben wird, sollte Informationen zur Ursache des Konflikts enthalten. Der Client sollte diese Nachricht überprüfen, um zu bestimmen, warum der Konflikt aufgetreten ist.
- Konflikt beheben: Der Client sollte geeignete Maßnahmen ergreifen, um den Konflikt zu lösen. Dies könnte das Aktualisieren der vorhandenen Ressource mit den richtigen Informationen oder das Löschen der konfliktverursachenden Ressource umfassen, falls diese nicht mehr benötigt wird.
- Anfrage erneut stellen: Sobald der Konflikt gelöst ist, kann der Client die ursprüngliche Anfrage erneut stellen. Wenn erfolgreich, sollte der Server mit einem 2xx-Erfolgscode antworten, wie z.B. 200 OK oder 201 Created.
Die spezifischen Schritte zur Behebung eines 409-Fehlers können je nach Kontext der Fehlermeldung variieren. In manchen Fällen muss der Client zusätzliche Schritte unternehmen, um sicherzustellen, dass die Ressource korrekt aktualisiert wird und der Konflikt vollständig gelöst ist.
Unterschied zwischen 409- und 412-Statuscode
Der Hauptunterschied zwischen einem 409 Konflikt- und einem 412 Vorbedingung fehlgeschlagen-Statuscode liegt im Kontext ihrer Verwendung:
- 409 Statuscode: Wird verwendet, um auf einen Konflikt mit dem aktuellen Zustand einer Ressource hinzuweisen, beispielsweise wenn versucht wird, eine Ressource zu erstellen oder zu aktualisieren, die bereits existiert oder widersprüchliche Informationen enthält.
- 412 Statuscode: Dieser Statuscode gibt an, dass eine Bedingung, die in den Anfrage-Headern angegeben wurde (z.B. If-Match oder If-None-Match), nicht erfüllt wurde. Der Server hat die im Anfrage-Header angegebenen Vorbedingungen überprüft und festgestellt, dass sie nicht zutreffen.
Beeinflusst ein http 409 Statuscode SEO?
Ein 409 Konflikt-Statuscode kann potenziell negative Auswirkungen auf SEO haben, wenn er häufig auftritt und die Nutzbarkeit oder Zugänglichkeit einer Website beeinträchtigt. Ein einzelner 409-Fehler ist jedoch unwahrscheinlich, signifikante Auswirkungen auf SEO zu haben.
Suchmaschinen sind darauf ausgelegt, Fehler zu handhaben und können in der Regel eine Website weiterhin crawlen und indexieren, auch wenn einige Ressourcen vorübergehend nicht verfügbar sind. Es ist wichtig, wiederkehrende 409-Fehler zu beheben, um sicherzustellen, dass die Website zugänglich und nutzbar bleibt, sowohl für Benutzer als auch für Suchmaschinen.