接口幂等设计怎么避免重复写入
网络重试、用户连点、队列重投,都会让同一个请求被执行多次,幂等设计是挡在数据前面的那道门。
重复请求从哪来
客户端超时重试、用户手抖连点两次、消息队列投递失败后重投,这三条路径都会让同一个业务动作被执行多遍。它们不是异常,而是常态。
如果没有防护,重复执行带来的后果按业务不同差别很大:轻则产生两条重复记录,重则重复扣款、重复发货,处理成本远高于设计成本。
幂等键怎么定
常见做法是由调用方生成一个绑定业务意图的键,随请求一起提交。服务端记录这个键的处理状态,同一个键再次到达时直接返回首次结果。
键的选择要能覆盖业务含义。用订单号比用时间戳稳妥,因为时间戳在高并发下可能碰撞,而订单号天然绑定一次业务意图。
状态机比布尔标记可靠
只记录“已处理”和“未处理”两种状态,遇到并发时容易漏判。用处理中、成功、失败三种状态,配合加锁或原子写入,才能覆盖中间态。
失败状态的复用要谨慎。业务失败后同一个键能否重试,取决于失败原因:参数错误重试也无意义,网络超时则可以放行重试。
清理与过期
幂等记录不能无限增长。通常按业务窗口设定保留时间,比如支付类保留数天,普通写操作保留数小时,过期后自动清理。
保留时间要覆盖最长的重试链路。若上游重试可能延迟到第二天,清理窗口就不能短于一天,否则第二次请求会被当成新请求处理。
几个容易踩的坑
第一是在网关层做幂等而没有在业务层做,网关重启后记录丢失,防护形同虚设。第二是把幂等键当成去重键,在批量场景里误伤正常请求。
第三是忽略并发。两个相同请求同时到达,查记录时都显示未处理,于是双双执行。解决办法是在写入前用原子操作占位,而不是先查后写。
本文由合亚嗒资讯网编辑部整理撰写,观点仅供参考;转载请注明来源与链接。