幂等性设计实战:别让你的接口被重复请求打穿

举报
yd_277423341 发表于 2026/11/16 06:08:23 2026/11/16
【摘要】 分布式系统里重复请求无处不在:客户端重试、网关重发、MQ 重复投递。本文对比唯一索引、幂等键+Redis、乐观锁版本号、状态机四种幂等方案,并总结幂等键 TTL、原子抢占、重复响应等落地细节与推荐组合。

为什么幂等是分布式系统的必修课

线上事故复盘时,有一类问题出现的频率高得惊人:用户只点了一次"支付",账户却被扣了两次款;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 字)

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。