下单页提交按钮在慢网下要等 1.8 秒才返回。用户点一次没反应,再点一次,接口收到两条 POST /api/order,库存扣了两次,财务当天对出 6 笔重复订单。前端只在 submit 回调里写了 button.disabled = true。
disabled 在第一次点击的同步代码里执行,理论上第二次点不到。但页面用的是自定义 div 按钮,监听的是 CLICk,禁用只加了 class,没设 pointer-events 和 tabindex,第二次点击照样进来。改成原生 button 加 disabled 后,仍有 1 例,来自 iOS 17 的双击手势,两次 click 在同一帧入队。
光靠前端拦不住,网络重试、用户回退再提交都能绕过。最终加幂等键:进入结算页时用 crypto.randomUUID() 生成一个 orderKey,存进 sessionStorage,提交时放在请求头 X-Idempotency-Key。服务端用唯一索引兜底,重复键直接返回第一次的订单号。
前端同时加三道:提交函数入口先判断 submitting 标志,置位在任何 await 之前;按钮设 disabled 和 pointer-events:none;请求返回后只有失败且可重试时才复位。这样连续双击只会发一条请求。
验证用 Chrome 120 的 Slow 3G 限速,连点 10 次提交,Network 里只有一条 POST,状态 201;服务端日志里 X-Idempotency-Key 出现 10 次,订单表只新增 1 行;再手动重放同一个 key,返回 200 和原订单号,库存不变。
let submitting = false;
async function submitOrder() {
if (submitting) return;
submitting = true;
btn.disabled = true;
try {
await fetch('/api/order', {
method: 'POST',
headers: { 'X-Idempotency-Key': orderKey },
body: payload
});
} catch (e) {
submitting = false;
btn.disabled = false;
}
} 