2026年10月22日星期四第 001 期heyada.com
合亚嗒资讯网

慢慢读,读完整

合亚嗒资讯网
技术 · 开发实战

接口幂等设计怎么避免重复写入

网络重试、用户连点、队列重投,都会让同一个请求被执行多次,幂等设计是挡在数据前面的那道门。

2026-11-11编辑部约 7 分钟4 条留言

重复请求从哪来

客户端超时重试、用户手抖连点两次、消息队列投递失败后重投,这三条路径都会让同一个业务动作被执行多遍。它们不是异常,而是常态。

如果没有防护,重复执行带来的后果按业务不同差别很大:轻则产生两条重复记录,重则重复扣款、重复发货,处理成本远高于设计成本。

幂等键怎么定

常见做法是由调用方生成一个绑定业务意图的键,随请求一起提交。服务端记录这个键的处理状态,同一个键再次到达时直接返回首次结果。

键的选择要能覆盖业务含义。用订单号比用时间戳稳妥,因为时间戳在高并发下可能碰撞,而订单号天然绑定一次业务意图。

状态机比布尔标记可靠

只记录“已处理”和“未处理”两种状态,遇到并发时容易漏判。用处理中、成功、失败三种状态,配合加锁或原子写入,才能覆盖中间态。

失败状态的复用要谨慎。业务失败后同一个键能否重试,取决于失败原因:参数错误重试也无意义,网络超时则可以放行重试。

清理与过期

幂等记录不能无限增长。通常按业务窗口设定保留时间,比如支付类保留数天,普通写操作保留数小时,过期后自动清理。

保留时间要覆盖最长的重试链路。若上游重试可能延迟到第二天,清理窗口就不能短于一天,否则第二次请求会被当成新请求处理。

几个容易踩的坑

第一是在网关层做幂等而没有在业务层做,网关重启后记录丢失,防护形同虚设。第二是把幂等键当成去重键,在批量场景里误伤正常请求。

第三是忽略并发。两个相同请求同时到达,查记录时都显示未处理,于是双双执行。解决办法是在写入前用原子操作占位,而不是先查后写。

本文由合亚嗒资讯网编辑部整理撰写,观点仅供参考;转载请注明来源与链接。

读者留言

共 4 条 · 精选展示
后
后端老王2026-11-11

先查后写这个坑太真实了,并发一起来两个请求都以为自己是第一个。

小
小陈2026-11-11

幂等键用订单号而不是时间戳,这个思路很清楚,回头就改。

阿
阿哲2026-11-11

失败状态能不能复用,确实要看失败原因,之前一刀切反而误伤。

林
林工2026-11-11

保留窗口要覆盖最长重试链路,这条差点忽略,幸好看到了。

延伸阅读