计算机网络 / 系统课时

理解 409 与 429

理解 409 与 429

409 Conflict 和 429 Too Many Requests 都表示服务器理解了请求,但拒绝按当前条件继续处理:前者强调资源当前状态与请求发生冲突,后者强调请求频率超过允许范围。正确区分后,客户端才能决定是刷新状态后重试,还是等待一段时间再发起请求。

学习目标

  • 能根据冲突原因在 409、412、422 等相近状态码之间做出合理选择。
  • 能为 429 返回可执行的退避信息,并让客户端按 Retry-After 控制重试。
  • 能用实际 HTTP 请求验证两种错误的响应状态、响应头和响应体。

什么时候返回 409

409 适合表达“请求本身可以理解,但与目标资源的当前状态冲突”。例如订单已经进入 PAID,客户端再次请求“取消未支付订单”;或者同一个业务键已经被占用,继续创建会破坏当前资源约束。响应体应告诉客户端冲突对象与当前状态,而不是只写一句 Conflict。

容易混淆的是条件请求:如果客户端通过 If-Match 携带 ETag,而服务器发现条件不成立,HTTP 语义更直接对应 412 Precondition Failed。字段格式合法但业务规则不允许时,也可能使用 422 Unprocessable Content;不要把所有业务失败都塞进 409。

下面用一个最小本地服务同时复现状态冲突和限流。保存为 server.py 后运行。

python
from http.server import BaseHTTPRequestHandler, HTTPServer
import json

class Handler(BaseHTTPRequestHandler):
    def write_json(self, status, body, headers=None):
        data = json.dumps(body).encode("utf-8")
        self.send_response(status)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(data)))
        for name, value in (headers or {}).items():
            self.send_header(name, value)
        self.end_headers()
        self.wfile.write(data)

    def do_POST(self):
        if self.path == "/orders/1001/cancel":
            self.write_json(409, {
                "code": "ORDER_STATE_CONFLICT",
                "message": "paid order cannot be cancelled",
                "currentState": "PAID"
            })
            return
        self.send_response(404)
        self.end_headers()

    def do_GET(self):
        if self.path == "/limited":
            self.write_json(429, {
                "code": "RATE_LIMITED",
                "message": "retry after 30 seconds"
            }, {"Retry-After": "30"})
            return
        self.send_response(404)
        self.end_headers()

HTTPServer(("127.0.0.1", 8080), Handler).serve_forever()

预期结果

text
服务启动后保持运行并监听 127.0.0.1:8080;终端暂时不会返回到命令提示符。

另开终端发送取消请求。

bash
curl -i -X POST http://127.0.0.1:8080/orders/1001/cancel

预期输出

text
HTTP/1.0 409 Conflict
Content-Type: application/json
Content-Length: 101

{"code": "ORDER_STATE_CONFLICT", "message": "paid order cannot be cancelled", "currentState": "PAID"}

实际输出还会包含 Server、Date 等由 Python 标准库自动生成的响应头,具体值随 Python 版本和时间变化。业务判断应依赖 409 与稳定错误码,而不是这些动态头字段。

什么时候返回 429

429 表示客户端在一段时间内发送了过多请求。限流可以按账号、API Key、IP、资源或它们的组合计数,但响应应明确告诉客户端何时再试。HTTP 标准定义了 Retry-After 响应头,它可以是“等待秒数”,也可以是 HTTP 日期。

例如接口限制为“每个 API Key 每分钟 60 次”,第 61 次请求可以返回 429,并附带 Retry-After: 30,表示客户端至少等待 30 秒。不要在客户端收到 429 后立即无间隔重试,否则会把限流放大成重试风暴。

继续使用上面的本地服务请求 /limited。

bash
curl -i http://127.0.0.1:8080/limited

预期输出

text
HTTP/1.0 429 Too Many Requests
Content-Type: application/json
Content-Length: 61
Retry-After: 30

{"code": "RATE_LIMITED", "message": "retry after 30 seconds"}

实际输出同样会额外包含动态的 Server 与 Date。如果服务端采用滑动窗口或令牌桶,剩余等待时间也会动态变化;此时 Retry-After 应由服务端根据真实窗口计算,客户端不要自行猜测固定等待值。

客户端如何重试

对 409 和 429 采用同一种重试策略通常是错误的。409 需要先获取最新资源状态、重新计算操作或交由用户决定;429 则通常等待后重试,并限制并发。一个实用规则是:状态没变就不要重复 409 请求,限流时间没到就不要重复 429 请求。

状态码 客户端第一动作 是否适合原样立即重试 常见辅助信息
409 重新读取资源状态并解决冲突 否 当前状态、冲突字段、可执行下一步
429 读取 Retry-After 并暂停请求 否 Retry-After、应用错误码
412 刷新 ETag 或前置条件 否 最新 ETag、条件失败原因

当接口能够让调用方据状态码直接决定下一步,错误处理就从“看字符串猜原因”变成可编程行为:409 先解决资源冲突,429 先等待限流窗口。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 409 与 429

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

登录哪都通