计算机网络 / 系统课时

理解安全与幂等

理解安全与幂等

HTTP 的“安全”和“幂等”决定客户端能否把请求当作只读操作,以及网络失败后能否自动重试。它们描述的是方法语义,不等于“有没有鉴权”或“每次状态码都相同”。掌握这两个属性后,可以为 GET、PUT、DELETE、POST 等方法制定更可靠的调用策略。

学习目标

  • 区分 HTTP 方法的安全性与幂等性
  • 判断常见方法发生超时后是否适合自动重试
  • 识别“返回结果不同但仍然幂等”的典型情况

安全表示客户端没有请求修改状态

HTTP 语义中,GET、HEAD、OPTIONS 和 TRACE 被定义为安全方法,意思是客户端没有请求服务器改变资源状态。安全并不要求服务器完全没有任何副作用:访问日志、计费统计或缓存填充都可能发生,但这些不是客户端请求的主要资源状态变更。

例如读取订单应使用 GET /orders/42,而不应设计成 GET /orders/42/cancel。后者虽然使用安全方法,却让一次读取语义的请求取消订单,代理、预取器或爬虫都可能意外触发业务修改。

可以直接检查一个读取接口:

bash
curl -i 'https://api.example.test/orders/42'

预期结果:读取接口应返回订单表示,而不会因为这次 GET 改变订单业务状态。实际字段由接口定义决定。

text
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”,重复发送相同表示仍得到相同目标状态:

bash
curl -i -X PUT 'https://api.example.test/users/42' \
  -H 'Content-Type: application/json' \
  --data '{"displayName":"Ada"}'

预期结果:成功后资源的目标状态是 displayName 为 Ada;再次发送完全相同的 PUT 不应把名称继续追加或产生第二个用户。

text
HTTP/1.1 200 OK
Content-Type: application/json

{"id":42,"displayName":"Ada"}

重试仍要设置上限。幂等只说明重复执行的预期资源效果,不意味着服务一定健康,也不意味着可以对持续返回失败的服务器无限发送请求。

POST 需要额外的防重复设计

创建支付、订单或消息时通常使用 POST。如果第一次请求已经在服务器成功,但响应在网络途中丢失,客户端直接重发同一个 POST,服务器可能创建第二笔订单。因此不能仅凭“超时”就判断第一次操作没有发生。

常见做法是在应用协议中加入唯一请求标识,并让服务器保存“请求标识 → 处理结果”的映射。例如客户端为一次下单生成 <ID>,重试时继续使用同一个值;服务器检测到已有记录后返回先前结果,而不是再次执行业务。具体头名和去重规则必须由 API 契约明确规定,不能假定所有 HTTP 服务都支持统一的幂等键。

设计调用策略时可以先看方法语义:只读操作保持安全,PUT、DELETE 等幂等操作允许受控重试;POST、PATCH 若业务上需要重试,则由服务端明确实现去重或幂等规则。这样即使发生超时,也能避免把“没有收到响应”错误地当成“服务器没有执行”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解安全与幂等

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通