首页

技术

频道首页— 前沿动态— 开发实战— 数码评测— 技术科普

科学

频道首页— 天文宇宙— 生命科学— 物理化学— 科学史话

电影

频道首页— 新片速递— 深度影评— 经典回顾— 幕后故事

娱乐

频道首页— 明星八卦— 综艺资讯— 音乐现场— 文化热点

养生

频道首页— 中医养生— 四季调养— 睡眠管理— 心理调适

健康

频道首页— 疾病预防— 营养饮食— 体检指南— 就医参考

运动

频道首页— 健身教程— 跑步骑行— 球类赛事— 运动康复

更多

全部文章站点目录 关于我们免责与版权
技术 · 开发实战2026-11-13编辑部约 4 分钟

重复请求不是意外:把幂等设计进接口的四个位置

编辑部3 条留言
本文要点
  1. 先分清三种重复
  2. 幂等键放在哪
  3. 状态机比标记更可靠
  4. 超时与重试的边界
  5. 把幂等写进验收

先分清三种重复

第一种是客户端超时后重发,服务端其实已经处理完;第二种是用户连点,两个请求几乎同时到达;第三种是消息重投,队列在确认丢失后再次投递。

三种重复的成因不同,防法也不同。前两种靠请求侧的标识,第三种靠消费侧的位点记录,混在一起谈容易漏掉其中一类。

幂等键放在哪

由调用方生成一个业务去重键,随请求带上,服务端用它做去重。键要能表达业务语义,比如订单号加操作类型,而不是随机串,否则重放时无法识别。

键的存储要和业务写入放在同一事务里。先查键再写业务的两步做法,在并发下会同时通过检查,最终仍然写了两遍。

状态机比标记更可靠

只打一个已处理的标记,遇到中途崩溃就说不清进度。把操作拆成待处理、处理中、已完成几个状态,重启后按状态续跑,重复请求自然被挡住。

状态迁移要写进同一条记录,避免出现标记已写、业务未落的中间态。迁移条件里带上版本号,可以挡住并发覆盖。

超时与重试的边界

重试要有上限和退避,且只在明确可重试的错误上触发。参数错误、权限不足这类失败,重试只会放大日志和压力。

服务端配合给出可重试标记,比让客户端凭状态码猜要稳。4xx 与 5xx 的边界在网关层常被改写,直接把语义写进响应体更可靠。

把幂等写进验收

验收清单里加一条:同一请求连续发送两次,第二次不得产生新的业务记录,也不得改变余额类字段。这条用脚本就能自动跑。

线上再补一层观测,统计去重命中次数。命中率突然归零,往往意味着客户端换了实现却没带键。

读者留言 共 4 条

运运维老张2026-11-13

并发下两步检查同时通过这个坑我们踩过,最后改成写在一张表里加去重索引才解决。

后后端小周2026-11-13

可重试标记写进响应体这条很实用,网关改状态码的事太常见了。

测测试阿岚2026-11-13

验收加连发两次的用例,跑起来几分钟,比线上出问题排查省事多了。

夜夜班值守2026-11-13

去重命中率这个指标之前没想过,确实能反映客户端有没有带键。

相关阅读