架构与系统设计 / 系统课时

重复请求怎样保证幂等

重复请求怎样保证幂等

客户端超时后重试、消息重复投递或网关自动重放,都可能让同一个业务动作到达服务端多次。幂等设计的目标不是禁止重试,而是让这些重复请求最终只产生一次业务效果,并且能安全返回第一次执行对应的结果。

学习目标

  • 使用业务幂等键识别同一次业务操作
  • 用唯一约束在并发条件下阻止重复创建
  • 用状态机限制同一对象的重复状态转换

幂等键必须代表业务动作

不能只用 HTTP 请求内容是否相同来判断重复,因为两个合法下单请求完全可能拥有相同商品和金额。更可靠的做法是由调用方为一次业务动作生成稳定的幂等键,例如 checkout-20261005-001,所有重试都携带同一个键,新的一次下单则生成新键。

服务端通常把幂等键和业务作用域一起保存,例如使用 (user_id, idempotency_key)。如果只让应用代码先查询“是否存在”再插入,在两个请求并发到达时仍可能同时查询到不存在,然后各自创建一条记录。因此最终防线应该落到数据库唯一约束。

重复请求经过幂等键、唯一约束与状态机的处理流程

用唯一约束挡住并发重复创建

下面用 PostgreSQL 演示最小实现。假设在一个空的测试 schema 中执行,同一用户的同一个幂等键只能创建一条订单;第二次请求通过 ON CONFLICT DO NOTHING 被数据库安全地合并。

sql
CREATE TABLE orders (
    order_id BIGINT PRIMARY KEY,
    user_id BIGINT NOT NULL,
    idempotency_key TEXT NOT NULL,
    status TEXT NOT NULL CHECK (status IN ('PENDING', 'PAID', 'CANCELED')),
    amount_cents INTEGER NOT NULL CHECK (amount_cents > 0),
    UNIQUE (user_id, idempotency_key)
);

INSERT INTO orders (order_id, user_id, idempotency_key, status, amount_cents)
VALUES (1001, 42, 'checkout-20261005-001', 'PENDING', 2599)
ON CONFLICT (user_id, idempotency_key) DO NOTHING;

INSERT INTO orders (order_id, user_id, idempotency_key, status, amount_cents)
VALUES (1002, 42, 'checkout-20261005-001', 'PENDING', 2599)
ON CONFLICT (user_id, idempotency_key) DO NOTHING;

SELECT order_id, user_id, idempotency_key, status, amount_cents
FROM orders;

预期输出

text
CREATE TABLE
INSERT 0 1
INSERT 0 0
 order_id | user_id |     idempotency_key     | status  | amount_cents
----------+---------+-------------------------+---------+-------------
     1001 |      42 | checkout-20261005-001   | PENDING |        2599
(1 row)

INSERT 0 0 表示第二次插入没有创建新行。真实接口通常不会直接把它当作失败,而会查询唯一键对应的既有订单,把已有 order_id 和业务状态返回给重试请求。

状态机阻止同一副作用执行两次

唯一键解决的是“同一次创建不要生成两个对象”,但已有对象上的支付、取消、发货等动作还需要状态约束。例如支付只能从 PENDING 进入 PAID。数据库条件更新可以把“检查旧状态”和“修改状态”合并成一次原子操作。

sql
UPDATE orders
SET status = 'PAID'
WHERE order_id = 1001
  AND status = 'PENDING';

UPDATE orders
SET status = 'PAID'
WHERE order_id = 1001
  AND status = 'PENDING';

SELECT order_id, status
FROM orders
WHERE order_id = 1001;

预期输出

text
UPDATE 1
UPDATE 0
 order_id | status
----------+--------
     1001 | PAID
(1 row)

第一次更新获得一行,说明状态转换成功;第二次获得零行,说明当前状态已经不是 PENDING,调用方不应再次执行扣款等副作用。对于更复杂的流程,可以把允许的状态转换明确建模,而不是让任意接口直接覆盖状态字段。

重试时应该返回什么

幂等请求命中已有记录后,应尽量返回第一次业务动作的稳定结果,而不是简单返回“重复请求”。例如首次创建订单成功但响应在网络中丢失,客户端重试时应得到同一个订单标识和当前状态,这样调用方才能继续后续流程。

如果第一次执行仍在处理中,可以返回明确的处理中状态;如果相同幂等键被重复使用却携带了不同金额或不同目标对象,则应拒绝请求,因为这已经不是同一个业务动作。实践中常把关键请求参数的摘要与幂等记录一起保存,用于识别这种冲突。

面试中把三层保护说完整即可:业务幂等键负责识别“是不是同一次操作”,数据库唯一约束负责抵抗并发竞态,状态机负责限制同一业务对象能执行哪些后续动作。三者组合后,网络重试可以被允许,而不会把重试变成重复业务副作用。

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

目录与阅读设置

记录一个想法

重复请求怎样保证幂等

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

登录哪都通