重试之外:接口幂等的落地细节
本文要点
- 为什么重试会重复
- 幂等键怎么设计
- 存储与并发
- 应该返回什么
- 边界与例外
为什么重试会重复
网络超时不代表请求没有到达。服务端可能已经处理完成,只是响应在回程丢失,客户端再发一次就变成了两条记录。
所以重试的前提是可判断的幂等:同一个业务动作无论执行几次,产生的副作用只应发生一次。
幂等键怎么设计
由客户端生成请求标识并随请求携带,服务端在处理前先查这个标识是否已被消费,已消费则直接返回上次的结果。
标识要与业务语义绑定,不能用时间戳或随机数替代,否则重试时系统无法识别为同一个动作。
存储与并发
查询与写入之间存在竞争,两个并发请求可能同时判定为未消费。用去重约束或原子占位把判断收敛到一次写操作。
占位记录要带过期时间,避免客户端崩溃后键被长期占用,导致后续合法请求被拒绝。
应该返回什么
重复请求应返回与首次一致的结果,而不是抛出错误。调用方据此可以安全重试,不必区分首次与重发。
处理中的状态可以返回明确的进行中标记,让调用方延迟重试,而不是立刻判定为失败。
边界与例外
并非所有接口都需要幂等。查询天然安全,写入才需要保护;把范围收窄,能减少不必要的存储开销。
幂等解决的是重复,不解决顺序。涉及状态机的操作,还要单独考虑乱序到达时的处理策略。
本文由万象资讯站编辑部整理撰写,观点仅供参考;转载请注明来源。
读者留言 共 4 条
码码农老周2026-11-09
超时响应丢失这个场景讲得准,之前真踩过。
青青衫2026-11-09
幂等键不能用随机数,这点很关键。
小小舟2026-11-09
并发那段说到了去重约束,落地感强。
阿阿哲2026-11-09
重复请求返回首次结果,这个约定清爽。