重复请求不是意外:把幂等设计进接口的四个位置
- 先分清三种重复
- 幂等键放在哪
- 状态机比标记更可靠
- 超时与重试的边界
- 把幂等写进验收
先分清三种重复
第一种是客户端超时后重发,服务端其实已经处理完;第二种是用户连点,两个请求几乎同时到达;第三种是消息重投,队列在确认丢失后再次投递。
三种重复的成因不同,防法也不同。前两种靠请求侧的标识,第三种靠消费侧的位点记录,混在一起谈容易漏掉其中一类。
幂等键放在哪
由调用方生成一个业务去重键,随请求带上,服务端用它做去重。键要能表达业务语义,比如订单号加操作类型,而不是随机串,否则重放时无法识别。
键的存储要和业务写入放在同一事务里。先查键再写业务的两步做法,在并发下会同时通过检查,最终仍然写了两遍。
状态机比标记更可靠
只打一个已处理的标记,遇到中途崩溃就说不清进度。把操作拆成待处理、处理中、已完成几个状态,重启后按状态续跑,重复请求自然被挡住。
状态迁移要写进同一条记录,避免出现标记已写、业务未落的中间态。迁移条件里带上版本号,可以挡住并发覆盖。
超时与重试的边界
重试要有上限和退避,且只在明确可重试的错误上触发。参数错误、权限不足这类失败,重试只会放大日志和压力。
服务端配合给出可重试标记,比让客户端凭状态码猜要稳。4xx 与 5xx 的边界在网关层常被改写,直接把语义写进响应体更可靠。
把幂等写进验收
验收清单里加一条:同一请求连续发送两次,第二次不得产生新的业务记录,也不得改变余额类字段。这条用脚本就能自动跑。
线上再补一层观测,统计去重命中次数。命中率突然归零,往往意味着客户端换了实现却没带键。
读者留言 共 4 条
并发下两步检查同时通过这个坑我们踩过,最后改成写在一张表里加去重索引才解决。
可重试标记写进响应体这条很实用,网关改状态码的事太常见了。
验收加连发两次的用例,跑起来几分钟,比线上出问题排查省事多了。
去重命中率这个指标之前没想过,确实能反映客户端有没有带键。