首页/网络/协议速查/412 Precondition Failed 前置条件失败
HTTP 方法与状态码91 条

412 Precondition Failed 前置条件失败

请求中的条件头(If-Match、If-Unmodified-Since 等)不成立,服务器拒绝执行。

协议速查网络更新于 2026-10-12
名称412 Precondition Failed
作用条件请求未满足
规范RFC 9110 §15.5.13
常见头If-Match / If-Unmodified-Since / If-None-Match

乐观锁更新

乐观锁更新
curl -si -X PUT https://api.example.com/docs/7 \
  -H 'If-Match: "v5"' -d @doc.md
# 若当前 ETag 是 "v6" → HTTP/1.1 412 Precondition Failed
412 适合做「防止覆盖他人修改」的乐观并发控制;操作是幂等的,客户端应重新拉取最新版本后重放。

数据来源与参考

  • RFC 9110 §15.5.13 412
  • RFC 9110 §13 条件请求

相关工具

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