计算机网络 / 系统课时
理解安全与幂等
理解安全与幂等
HTTP 的“安全”和“幂等”决定客户端能否把请求当作只读操作,以及网络失败后能否自动重试。它们描述的是方法语义,不等于“有没有鉴权”或“每次状态码都相同”。掌握这两个属性后,可以为 GET、PUT、DELETE、POST 等方法制定更可靠的调用策略。
学习目标
- 区分 HTTP 方法的安全性与幂等性
- 判断常见方法发生超时后是否适合自动重试
- 识别“返回结果不同但仍然幂等”的典型情况
安全表示客户端没有请求修改状态
HTTP 语义中,GET、HEAD、OPTIONS 和 TRACE 被定义为安全方法,意思是客户端没有请求服务器改变资源状态。安全并不要求服务器完全没有任何副作用:访问日志、计费统计或缓存填充都可能发生,但这些不是客户端请求的主要资源状态变更。
例如读取订单应使用 GET /orders/42,而不应设计成 GET /orders/42/cancel。后者虽然使用安全方法,却让一次读取语义的请求取消订单,代理、预取器或爬虫都可能意外触发业务修改。
可以直接检查一个读取接口:
curl -i 'https://api.example.test/orders/42'预期结果:读取接口应返回订单表示,而不会因为这次 GET 改变订单业务状态。实际字段由接口定义决定。
HTTP/1.1 200 OK
Content-Type: application/json
{"id":42,"status":"paid"}如果执行一次 GET 后订单从 paid 变成 cancelled,问题不是 HTTP 本身失效,而是接口实现违反了所声明的方法语义。
幂等关注重复执行后的最终效果
幂等表示对同一个目标连续发送多个相同请求,其预期服务器效果与发送一次相同。安全方法天然属于幂等方法;PUT 和 DELETE 也被定义为幂等。POST、PATCH 和 CONNECT 则没有被 HTTP 通用语义定义为幂等。
| 方法 | 安全 | 幂等 | 常见语义 |
|---|---|---|---|
GET |
是 | 是 | 读取资源 |
HEAD |
是 | 是 | 只取响应头语义 |
OPTIONS |
是 | 是 | 查询通信能力 |
PUT |
否 | 是 | 用给定表示创建或整体替换目标资源 |
DELETE |
否 | 是 | 删除目标资源 |
POST |
否 | 否 | 提交处理、创建从属资源等 |
PATCH |
否 | 否 | 对资源应用部分修改 |
以 DELETE /sessions/42 为例,第一次可能返回 204 No Content,第二次因为资源已经不存在而返回 404 Not Found。两个响应状态不同,但删除后的最终资源状态仍然是“不存在”,因此这并不破坏 DELETE 的幂等语义。
把方法语义转换成重试策略
网络超时最棘手的情况是客户端不知道服务器是否已经执行请求。对幂等方法,可以在确认故障属于暂时性问题后进行有限次数重试;对非幂等方法,自动重发可能把一次业务操作执行两遍。
一个实用策略是:连接中断、连接重置,或收到明确可重试的 502、503、504 时,对幂等请求最多重试 2~3 次,并采用指数退避,例如等待约 200 ms、400 ms、800 ms,同时加入少量随机抖动,避免大量客户端同时重试。
假设以下 PUT 的接口契约是“把用户 42 的显示名称设置为 Ada”,重复发送相同表示仍得到相同目标状态:
curl -i -X PUT 'https://api.example.test/users/42' \
-H 'Content-Type: application/json' \
--data '{"displayName":"Ada"}'预期结果:成功后资源的目标状态是 displayName 为 Ada;再次发送完全相同的 PUT 不应把名称继续追加或产生第二个用户。
HTTP/1.1 200 OK
Content-Type: application/json
{"id":42,"displayName":"Ada"}重试仍要设置上限。幂等只说明重复执行的预期资源效果,不意味着服务一定健康,也不意味着可以对持续返回失败的服务器无限发送请求。
POST 需要额外的防重复设计
创建支付、订单或消息时通常使用 POST。如果第一次请求已经在服务器成功,但响应在网络途中丢失,客户端直接重发同一个 POST,服务器可能创建第二笔订单。因此不能仅凭“超时”就判断第一次操作没有发生。
常见做法是在应用协议中加入唯一请求标识,并让服务器保存“请求标识 → 处理结果”的映射。例如客户端为一次下单生成 <ID>,重试时继续使用同一个值;服务器检测到已有记录后返回先前结果,而不是再次执行业务。具体头名和去重规则必须由 API 契约明确规定,不能假定所有 HTTP 服务都支持统一的幂等键。
设计调用策略时可以先看方法语义:只读操作保持安全,PUT、DELETE 等幂等操作允许受控重试;POST、PATCH 若业务上需要重试,则由服务端明确实现去重或幂等规则。这样即使发生超时,也能避免把“没有收到响应”错误地当成“服务器没有执行”。