HTTP 方法参考¶

HTTP 方法表达客户端希望对目标资源执行的语义。安全、幂等、可缓存是不同属性；它们不等同于“不会失败”“没有日志”或“没有请求体”。

方法对照¶

方法	主要语义	安全	幂等	响应通常可缓存
`GET`	获取资源当前表示	是	是	是
`HEAD`	获取与 GET 相同的响应头，不返回响应体	是	是	是
`POST`	按资源定义处理提交内容	否	否	仅满足明确条件时
`PUT`	用请求表示创建或完整替换目标资源	否	是	通常否
`PATCH`	对资源应用部分修改	否	不一定	通常否
`DELETE`	删除目标资源的关联	否	是	否
`OPTIONS`	查询通信选项或 CORS 能力	是	是	通常否
`CONNECT`	建立到目标的隧道	否	否	否
`TRACE`	诊断请求回环	是	是	否

“通常可缓存”不代表浏览器一定缓存；还要满足状态码、认证上下文和缓存响应头要求。

GET 在协议语义上是安全且幂等的，但不保证物理上“无副作用”。服务器可以记录访问、更新统计或产生计费；这些附带行为不应改变客户端请求的资源状态。不得把删除、付款、发信等状态修改设计为 GET，否则预取、爬虫、缓存和重试可能触发操作。

要点	说明
参数位置	常放查询字符串，但 GET 语义不由参数位置决定
请求体	语义未被普遍定义，许多客户端、代理和服务端不支持
敏感数据	查询可能进入历史、日志、缓存键和 Referer
条件请求	`If-None-Match`、`If-Modified-Since` 可获得 `304`
HEAD 响应	应与对应 GET 的头一致，但不发送响应体

方法	目标 URI 通常由谁选择	重复请求风险	典型用途
`POST`	服务器或集合语义决定新资源	默认非幂等，重复可能创建两次或扣款两次	创建子资源、执行命令、复杂提交
`PUT`	客户端知道并指定目标 URI	幂等，重复完整替换的预期效果相同	创建或完整替换已知 URI 的资源
`PATCH`	客户端指定目标 URI	取决于补丁格式和业务设计	部分字段修改、应用补丁文档

POST 非幂等不表示它不能被设计成业务幂等。支付、创建订单等接口可使用幂等键、唯一约束和结果查询，使网络超时后的安全重试成为可能。

PUT 的幂等性针对请求的预期效果；服务器仍可更新审计日志或版本记录。 PATCH 若表达“将名称设为 X”可能幂等，若表达“余额增加 10”通常不幂等。

隐藏按钮、改用 POST 或设置 CORS 都不能替代服务端授权。所有敏感方法和凭据均应通过 HTTPS；方法本身不提供保密性。