首页/网络/协议速查/409 Conflict 请求冲突
HTTP 方法与状态码91 条

409 Conflict 请求冲突

请求与目标资源当前状态冲突:并发编辑冲突、唯一键重复、状态机不允许的操作等。

协议速查网络更新于 2026-10-12
名称409 Conflict
作用资源状态冲突
规范RFC 9110 §15.5.10
典型场景乐观锁版本冲突(If-Match 失败时也可用 412)

版本冲突交互

版本冲突交互
curl -si -X PUT https://api.example.com/docs/7 \
  -H 'If-Match: "v5"' -d @doc.md
# HTTP/1.1 409 Conflict(或 412 Precondition Failed)
# {"error":"version_conflict","current":"v6"}
WebDAV 中 409 也用于父目录不存在等结构性冲突;排查时先看响应体说明的业务原因。

易错点

  • 唯一键冲突返回 500 是常见实现缺陷:应显式映射为 409 并说明冲突字段

数据来源与参考

  • RFC 9110 §15.5.10 409 Conflict

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌