多人游戏与网络同步 / 系统课时
购买请求怎样做到幂等
购买请求怎样做到幂等
断线重连最危险的不是请求失败,而是客户端不知道上一次购买是否已经成功。如果重试时再次扣款或再次发奖,就会造成重复消费。解决办法是让一次业务操作始终携带同一个请求 ID,并由服务端保存这次操作的最终结果。
学习目标
- 为购买、支付、领奖等一次性操作定义稳定的幂等键
- 理解服务端幂等记录从占位、执行到返回缓存结果的流程
- 正确处理同一请求 ID 的重试、参数冲突与处理中状态
幂等保护的是业务操作
幂等不是“接口多调用几次都没关系”,而是同一个业务意图重复到达服务端时,只产生一次业务效果。例如玩家点击“购买金币包”,网络在响应返回前断开:服务端可能已经扣款并发货,但客户端只看到超时。重连后必须重放原请求,而不是创建一个新购买。
客户端应在第一次发起业务操作时生成 requestId,后续因超时、断线或重连产生的重试都复用它。只有玩家明确发起另一笔购买时,才生成新的 ID。服务端还应把关键参数做指纹,例如商品 ID、数量、玩家 ID;如果同一 requestId 携带了不同参数,应直接拒绝,而不是复用旧结果。
服务端怎样判定第一次与重试
一条可靠的幂等记录至少需要保存:requestId、玩家或账户、操作类型、请求指纹、处理状态和最终响应。推荐流程是先以唯一约束写入“处理中”记录,再执行扣款与发货,最后把结果写回同一记录。

关键点是幂等记录与真正的扣款、发货必须位于可恢复的一致性边界内。生产环境通常用数据库唯一键、事务和订单表实现;只把请求 ID 放在进程内存中,服务重启后就会失去保护。
用一个可运行示例验证重复请求
下面的 Node.js 示例用内存 Map 模拟幂等表,重点验证三件事:第一次执行会产生业务结果;同一请求重复到达时返回原结果;同一请求 ID 被错误复用于不同商品时拒绝处理。生产环境应把 Map 换成带唯一约束的持久化存储,并把幂等记录与业务写入放进一致的事务边界。
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);
}预期输出:
{ 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。这样可以把“网络是否收到响应”与“业务是否已经发生”彻底分开,避免把连接故障变成重复扣款或重复发奖。