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

PATCH 部分修改资源

对资源做局部修改的方法(RFC 5789 定义),请求体是「补丁文档」,语义由媒体类型决定。

协议速查网络更新于 2026-10-12
名称PATCH
作用按补丁文档部分修改资源
规范RFC 5789;JSON Merge Patch RFC 7386、JSON Patch RFC 6902
特性非安全;是否幂等取决于补丁内容

常见补丁格式

媒体类型用途示例
application/merge-patch+json合并式修改,类似递归 merge{"age":31}
application/json-patch+json操作序列 add/remove/replace[{"op":"replace","path":"/age","value":31}]
application/x-www-form-urlencoded简单字段更新(如部分框架)age=31

PATCH 请求

PATCH 请求
curl -i -X PATCH https://api.example.com/users/101 \
  -H 'Content-Type: application/merge-patch+json' \
  -d '{"age":31}'

易错点

  • PATCH 不一定幂等:数组追加类补丁重复执行会重复生效
  • 用 application/json 发 PATCH 而不声明补丁类型,服务端可能返回 415

数据来源与参考

  • RFC 5789 PATCH 方法
  • RFC 7386 JSON Merge Patch
  • RFC 6902 JSON Patch

相关工具

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