多人游戏与网络同步 / 系统课时

购买请求怎样做到幂等

购买请求怎样做到幂等

断线重连最危险的不是请求失败,而是客户端不知道上一次购买是否已经成功。如果重试时再次扣款或再次发奖,就会造成重复消费。解决办法是让一次业务操作始终携带同一个请求 ID,并由服务端保存这次操作的最终结果。

学习目标

  • 为购买、支付、领奖等一次性操作定义稳定的幂等键
  • 理解服务端幂等记录从占位、执行到返回缓存结果的流程
  • 正确处理同一请求 ID 的重试、参数冲突与处理中状态

幂等保护的是业务操作

幂等不是“接口多调用几次都没关系”,而是同一个业务意图重复到达服务端时,只产生一次业务效果。例如玩家点击“购买金币包”,网络在响应返回前断开:服务端可能已经扣款并发货,但客户端只看到超时。重连后必须重放原请求,而不是创建一个新购买。

客户端应在第一次发起业务操作时生成 requestId,后续因超时、断线或重连产生的重试都复用它。只有玩家明确发起另一笔购买时,才生成新的 ID。服务端还应把关键参数做指纹,例如商品 ID、数量、玩家 ID;如果同一 requestId 携带了不同参数,应直接拒绝,而不是复用旧结果。

服务端怎样判定第一次与重试

一条可靠的幂等记录至少需要保存:requestId、玩家或账户、操作类型、请求指纹、处理状态和最终响应。推荐流程是先以唯一约束写入“处理中”记录,再执行扣款与发货,最后把结果写回同一记录。

购买请求的服务端幂等处理流程

关键点是幂等记录与真正的扣款、发货必须位于可恢复的一致性边界内。生产环境通常用数据库唯一键、事务和订单表实现;只把请求 ID 放在进程内存中,服务重启后就会失去保护。

用一个可运行示例验证重复请求

下面的 Node.js 示例用内存 Map 模拟幂等表,重点验证三件事:第一次执行会产生业务结果;同一请求重复到达时返回原结果;同一请求 ID 被错误复用于不同商品时拒绝处理。生产环境应把 Map 换成带唯一约束的持久化存储,并把幂等记录与业务写入放进一致的事务边界。

js
const crypto = require("node:crypto");

const records = new Map();
let balance = 100;

function fingerprint(payload) {
  return crypto
    .createHash("sha256")
    .update(JSON.stringify(payload))
    .digest("hex");
}

function purchase(requestId, payload) {
  const fp = fingerprint(payload);
  const existing = records.get(requestId);

  if (existing) {
    if (existing.fingerprint !== fp) {
      throw new Error("IDEMPOTENCY_KEY_REUSED_WITH_DIFFERENT_PAYLOAD");
    }
    return { ...existing.response, replayed: true };
  }

  if (balance < payload.price) {
    throw new Error("INSUFFICIENT_BALANCE");
  }

  balance -= payload.price;
  const response = {
    orderId: "order-1001",
    itemId: payload.itemId,
    balance
  };

  records.set(requestId, {
    fingerprint: fp,
    response
  });

  return { ...response, replayed: false };
}

const requestId = "req-player42-0001";
const payload = { itemId: "gold-pack", price: 30 };

console.log(purchase(requestId, payload));
console.log(purchase(requestId, payload));

try {
  purchase(requestId, { itemId: "diamond-pack", price: 50 });
} catch (error) {
  console.log(error.message);
}

预期输出:

text
{ orderId: 'order-1001', itemId: 'gold-pack', balance: 70, replayed: false }
{ orderId: 'order-1001', itemId: 'gold-pack', balance: 70, replayed: true }
IDEMPOTENCY_KEY_REUSED_WITH_DIFFERENT_PAYLOAD

第二次调用没有再次把余额从 70 扣到 40,说明重复请求只复用了第一次结果。真实系统中的订单号、时间戳等动态值可能不同,但同一个请求 ID 对应的业务结果必须保持一致。

重连场景还要处理处理中状态

真正的难点是“请求已经开始,但服务端还没有形成最终结果”。如果客户端在这个窗口断线,服务端不能因为重试又执行一次,也不应把未知状态伪装成失败。常见做法是让幂等记录存在 PROCESSING、SUCCEEDED、FAILED 等状态,并为处理中记录设置可恢复策略。

对于支付或领奖,客户端重连后应继续携带原 requestId 查询或重试。若服务端已成功,就返回缓存结果;若仍在处理,就返回明确的处理中状态;若确认失败且允许重新发起,则由业务规则决定是否继续复用原 ID。这样可以把“网络是否收到响应”与“业务是否已经发生”彻底分开,避免把连接故障变成重复扣款或重复发奖。

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

目录与阅读设置

阅读设置

17

记录一个想法

购买请求怎样做到幂等

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

登录哪都通