首页/网络/协议速查/PUT 全量替换资源
本包目录(405 条)
HTTP 方法与状态码91 条
HTTP 头与缓存70 条DNS 与域名解析60 条TCP 与 UDP54 条TLS 与加密50 条IP 与 ICMP37 条邮件与文件传输43 条

PUT 全量替换资源

用请求体完整替换目标资源的表示,幂等:同一请求执行一次与多次结果一致。

协议速查网络更新于 2026-10-12
名称PUT
作用创建或全量替换目标资源
规范RFC 9110 §9.3.4
特性幂等;创建成功通常返回 201,替换成功 204 或 200

PUT 全量替换

PUT 全量替换
curl -i -X PUT https://api.example.com/users/101 \
  -H 'Content-Type: application/json' \
  -d '{"name":"alice","age":30}'
# HTTP/1.1 204 No Content
PUT 是「替换」而不是「合并」:未提供字段的语义由资源定义决定,多数实现会清空未提供字段——部分更新应使用 PATCH。

易错点

  • 把 PUT 当成部分更新用(漏传字段被清空)是常见事故;部分更新请用 PATCH
  • PUT 到不存在的资源是否创建由服务端决定,客户端不能假定一定会创建

数据来源与参考

  • RFC 9110 §9.3.4 PUT
  • RFC 9110 §9.2.2 幂等

相关工具

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