幂等性设计实战:别让你的接口被重复请求打穿
为什么幂等是分布式系统的必修课
线上事故复盘时,有一类问题出现的频率高得惊人:用户只点了一次"支付",账户却被扣了两次款;MQ 消息只投递了一条,订单却创建了两个。这类问题的根源往往不是逻辑写错了,而是系统没有做幂等设计。
所谓幂等,就是同一个操作执行一次和执行 N 次,结果完全相同。在分布式环境下,重复请求几乎是必然出现的:网络超时后的客户端重试、网关层的失败重发、MQ 的 at-least-once 投递语义、用户的手速双击——每一个环节都可能让你的写接口被调用不止一次。所以幂等不是"锦上添花"的优化项,而是写接口的底线要求。
常见方案对比与适用场景
1. 数据库唯一索引(最朴素也最可靠)
在业务主键上加唯一约束,重复插入直接被数据库拒绝。例如订单表的 order_no 加唯一索引,重复创建订单会抛出 DuplicateKeyException,捕获后直接返回已有订单即可。优点是简单可靠,不依赖额外组件;缺点是只能覆盖"插入"型操作,对更新型操作无能为力。
2. 幂等键 + Redis(最常用的通用方案)
客户端生成一个唯一请求标识(幂等键,通常用 UUID 或"业务ID+时间戳"),服务端处理前先 SET key value NX EX ttl 抢占:抢占成功说明是首次请求,正常执行业务;抢占失败则说明重复请求,直接拒绝或返回上次结果。关键细节有三个:
- TTL 要覆盖业务执行的最大时长,太短会出现"处理中键过期、重试又进来"的窗口;
-
-
普通的"先删键再执行业务"是错的——业务失败后键已删除,重试才能进来,这是对的;但如果业务成功而删键失败,就会留下脏键。推荐反过来:先抢占键,业务成功后保留键作为"已处理"标记;
-
-
要考虑原子性,抢占与业务执行之间如果服务宕机,锁会卡住请求直到 TTL 过期,所以需要给执行中状态设计续期或提前释放策略。
-
3. 乐观锁版本号(更新型操作首选)
-
-
UPDATE account SET balance = balance - 100, version = version + 1 WHERE id = 1 AND version = 5。影响行数为 0 说明版本已变化(被处理过或被并发修改),拒绝本次操作。它不需要额外组件,天然适配更新场景,代价是表中要维护 version 字段,且高并发下重试率会上升。
-
- 4. 状态机(流程型业务的天然防线)
订单从"待支付→已支付→已发货"单向流转,每次更新都带上前置状态条件:UPDATE orders SET status = 'PAID' WHERE id = ? AND status = 'UNPAID'。重复的支付回调第二次进来时,状态已经不是 UNPAID,影响行数为 0,自然被挡掉。状态机的好处是把幂等和业务流转规则统一建模,审计和排查也清晰。
落地时的几个坑
坑一:只有"拦截"没有"回应"。 拦截重复请求后直接抛"重复提交"异常,会让重试方继续重试形成风暴。正确做法是保存首次请求的处理结果,重复请求直接返回相同结果(响应也幂等)。
坑二:幂等键由服务端生成。 服务端为每个请求生成新 ID 等于没有幂等。幂等键必须来自请求发起方——客户端的请求 ID、MQ 的 message key、上游服务的 trace 标识。
坑三:忘记并发重复。 幂等键方案能拦住"先后到达"的重复,但两个相同请求同时到达时,GET 判断再 SET 这种非原子操作会双双通过。所以抢占必须用 Redis 的 SET NX(原子)或数据库的 INSERT ... ON DUPLICATE KEY,把判断和记录合并成一个原子动作。
坑四:读接口不管幂等。 大多数读接口天然幂等,但带副作用的读除外——"查询并计入浏览量"这种接口,重复调用会重复计数,副作用部分要单独拆出来做幂等。
一个推荐组合
实践中比较稳妥的组合是:前端防抖(减少手抖)→ 网关/接入层幂等键抢占(拦住重试)→ 数据库唯一索引或乐观锁兜底(最终防线)。三层各管一段,任何一层失效都不至于造成资金或数据事故。
幂等设计的本质,是承认"重复请求一定会发生"这个现实,然后为每一次重复准备好确定的答案。把幂等当成写接口的默认配置而不是事后补丁,系统在重试、降级、补偿这些分布式必备机制面前,才能真正站稳。
(全文约 1600 字)
- 点赞
- 收藏
- 关注作者
评论(0)