HTTP 与 Web 标准 / 系统课时
判断请求是否安全和幂等
判断请求是否安全和幂等
网络超时后最难判断的不是“能不能再发一次”,而是第一次请求是否已经在服务器生效。本篇用安全性与幂等性两个维度判断 HTTP 方法,并据此决定哪些请求适合自动重试,哪些必须先做去重或确认结果。
学习目标
- 区分安全方法与幂等方法,不把“只读”和“可重试”混为一谈。
- 判断 GET、PUT、DELETE、POST 等常见方法的默认语义。
- 在超时、断线等结果不确定的场景中选择合适的重试策略。
安全和幂等解决的是不同问题
安全描述请求的意图:客户端没有要求服务器改变资源状态。按照 HTTP 语义,GET、HEAD、OPTIONS 和 TRACE 属于安全方法。安全不等于服务器完全没有副作用,访问日志、计数器或缓存填充仍可能发生;关键是这些副作用不是客户端请求的业务目标。
幂等描述重复执行后的目标效果:对同一个资源发送多次内容相同的请求,其预期效果与发送一次相同。安全方法天然应当是幂等的,PUT 和 DELETE 也被定义为幂等;POST 与 PATCH 默认不能假定幂等。
| 方法 | 安全 | 幂等 | 典型语义 |
|---|---|---|---|
| GET | 是 | 是 | 读取资源 |
| HEAD | 是 | 是 | 只取响应头 |
| PUT | 否 | 是 | 创建或完整替换目标资源 |
| DELETE | 否 | 是 | 删除目标资源 |
| POST | 否 | 否 | 提交处理、创建从属资源等 |
| PATCH | 否 | 不保证 | 对资源做部分修改 |
用重复 PUT 看懂幂等
片段示例:假设服务端提供 /profiles/42,并按照 PUT 语义用请求中的表示替换该资源。下面两次请求内容完全相同。
PUT /profiles/42 HTTP/1.1
Host: api.example.test
Content-Type: application/json
{"nickname":"neo","language":"zh-CN"}预期结果:无论该请求被发送一次还是重复发送,只要服务端正确实现 PUT 语义,资源最终都应保持同一状态;具体状态码可以因资源原先是否存在而不同。
最终资源状态:
nickname = neo
language = zh-CN这就是幂等关注的重点:比较的是服务器上的最终效果,而不是比较每次响应文本是否逐字一致。
为什么网络重试要先判断幂等性
假设客户端发送请求后连接断开。客户端只知道“没有收到响应”,却无法确定服务器是完全没收到请求、执行到一半,还是已经执行成功但响应丢失。
对于 GET、PUT、DELETE 这类按规范具有幂等语义的方法,客户端通常可以在连接失败后重试,因为重复请求不应造成额外的业务效果。对于 POST,则不能仅凭“超时”就自动重复发送;如果第一次实际上已经成功,第二次可能再次创建订单、再次扣款或再次触发任务。
非幂等请求怎样安全重试
确实需要重试 POST 等非幂等操作时,应把“重复请求只产生一次业务结果”设计到应用层。常见做法包括使用唯一业务请求号、服务端去重记录,或采用接口明确支持的幂等键机制。
重试前还要区分失败类型。DNS 失败、连接尚未建立通常意味着请求大概率未发送;读取响应超时则可能发生在服务器已经处理完成之后。越接近“服务器可能已执行但客户端不知道”的场景,越不能依赖盲目重发。
判断顺序可以固定为:先看方法语义,再看接口实现是否真的幂等,最后结合失败发生的位置决定是否自动重试。这样能避免把“没有收到响应”误判成“请求一定没有执行”。