news 2026/8/1 23:53:58

手抖点了两次付款,为什么没扣我两笔钱?聊聊接口幂等性

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
手抖点了两次付款,为什么没扣我两笔钱?聊聊接口幂等性

【幂等性】分布式系统基石:深入解析幂等性设计与实现方案


人生没有太晚的开始

文章目录

  • 【幂等性】分布式系统基石:深入解析幂等性设计与实现方案
  • 前言
  • 一、概念定义——什么是幂等?
  • 二、保证幂等解决方案
    • 1.前端置灰按钮(不能保证幂等)
    • 2.数据库唯一索引(Unique Key)
    • 3.乐观锁
    • 4.防重Token令牌
    • 5.分布式锁
    • 6.状态机幂等(Status Machine)—— 业务层面的优雅
  • 总结与最佳实践

前言

  • 用户在手机弱网环境下买东西,点击“立即支付”,界面转圈圈没反应。用户心急又点了一次。

  • 浏览器发出了两次请求,如果后端没有幂等处理,用户就会被扣两次款。这在生产环境中是 P0 级事故。

  • 为了解决这个问题,我们需要引入“幂等性”。


一、概念定义——什么是幂等?

定义:对同一个系统,使用同样的条件,一次请求和重复的多次请求对系统资源的影响是一致的。

生活中的例子:

  • 电梯按钮(幂等): 你按一次“10楼”,电梯去10楼;你狂按一百次,电梯还是去10楼,不会飞出去。

  • 取款(非幂等): 你取100块,卡里少100;你连取两次,卡里少200。

HTTP 语义中的幂等:

  • GET(查询):天然幂等。

  • PUT(更新):通常是幂等的(把 A 改成 1,改多少次 A 都是 1)。

  • POST(新增):非幂等(每次调用都会创建新资源),这是我们要防范的重点。


二、保证幂等解决方案

1.前端置灰按钮(不能保证幂等)

当用户点击了一次扣款按钮后,前端将按钮置成灰色,防止用户提交两次。
问题

  • 可以通过postman等工具重复发送请求
  • 当网络波动时,通常会有重试机制导致重复发送

2.数据库唯一索引(Unique Key)

这是博主在项目中使用的一种方式,通过设置了唯一索引,就算多个重复请求,数据库会抛出异常,保证了幂等性。
适用:插入型操作(防重),例如插入一条新订单,不会插入两条。
缺点: 依赖数据库,分库分表时需要注意路由。

3.乐观锁

原理: update t_goods set count = count - 1, version = version + 1 where id = 1 and version = 1。
核心: 带上版本号。如果别人改过了,版本号变了,你的 SQL 就不生效。
适用: 更新库存、扣款。

4.防重Token令牌

原理

  • 进入页面前,先请求后端拿一个 Token。后端从redis拿一个Token返回。

  • 前端提交表单时带上这个 Token。

  • 后端执行 Redis.del(Token)。如果删除成功(返回1),说明是第一次,进入业务流程;如果删除失败(返回0),说明已经提交过了。

核心:在业务流程开始前进行了幂等判断,而不是像第一种数据库唯一索引那种方法(在业务中抛异常来确保幂等)。

5.分布式锁

原理:类似于防重Token令牌,也是在业务进行前进行幂等处理,业务执行前先抢锁(key=业务唯一ID),执行完释放锁。
注意点: 锁要设过期时间(防死锁);还要考虑一下看门狗机制的引入(防止业务流程还没有完成就释放了锁)

6.状态机幂等(Status Machine)—— 业务层面的优雅

这个例子有点像乐观锁,这个方案的核心在于:流程不可逆,利用当前状态做天然屏障。

生活中的例子
快递状态:待发货 -> 已发货 -> 已签收。

如果现在的状态是 已发货,你发来一个指令说“把状态改为已发货”,系统执行也没事(结果不变)。

如果现在的状态是 已签收,你发来一个指令说“把状态改为已发货”,系统直接拒绝,因为流程不能倒着走。

技术实现细节
这是最优雅、性能最好的方案,因为它不依赖 Redis,直接利用业务数据库的行锁。

SQL 的魔法: 不要先 SELECT 查状态,再 Java 判断,再 UPDATE(这会有并发缝隙)。 要直接把条件写在 UPDATE 语句里。

UPDATE ordersSETstatus='PAID'WHEREid=123ANDstatus='PENDING';

只能由PENDING变为PAID,不可能倒过来。


总结与最佳实践

  • 不要过度设计: 不是所有接口都要幂等,查询接口不需要,QPS 很低且允许少量重复的后台接口也没必要搞太复杂。

  • 唯一 ID 是关键: 无论是哪种方案,都需要一个全局唯一的 ID来标识“这是同一个请求”。

  • 推荐组合: 这里的“银弹”通常是 Token 机制(防误触) + 数据库唯一索引(兜底)。

以上就是幂等的内容了,有任何不足欢迎大佬指正。如果文章对您有所帮助,请务必点赞,收藏,您的支持就是我的最大动力!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/7/31 8:42:55

替代FinalShell,一款更高效、更智能的开源终端神器!

在我们日常工作中,终端操作是不可或缺的一环。传统的命令行工具往往功能单一,界面单调,难以满足现代开发的高效需求。今天给大家介绍一款智能命令行终端应用——T-Shell,它不仅重新定义了命令行的交互方式,还通过开源社…

作者头像 李华
网站建设 2026/8/1 13:54:01

2025年 Java 面试八股文汇总

我相信大多 Java 开发的程序员或多或少经历过 BAT 一些大厂的面试,也清楚一线互联网大厂 Java 面试是有一定难度的,小编经历过多次面试,有满意的也有备受打击的。因此呢小编想把自己这么多次面试经历以及近期的面试真题来个汇总分析&#xff…

作者头像 李华
网站建设 2026/8/1 21:35:30

北极之蓝:Nord主题如何用色彩美学重塑编程体验

北极之蓝:Nord主题如何用色彩美学重塑编程体验 【免费下载链接】nord An arctic, north-bluish color palette. 项目地址: https://gitcode.com/gh_mirrors/no/nord 深夜,当屏幕的光芒成为唯一的光源,你是否曾因刺眼的配色而感到视觉疲…

作者头像 李华
网站建设 2026/8/1 12:57:36

JavaScript学习笔记:3.控制流与错误处理

JavaScript学习笔记:3.控制流与错误处理 上一篇搞定了JS的“内功心法”(基础语法与数据类型),这一篇咱们来解锁JS的“实战技能”——控制流与错误处理。如果说变量和数据类型是JS的“砖瓦”,那控制流就是“建筑图纸”&…

作者头像 李华
网站建设 2026/8/1 17:15:02

从零构建智能开发助手:Trae Agent配置即代码实战解析

从零构建智能开发助手:Trae Agent配置即代码实战解析 【免费下载链接】trae-agent Trae 代理是一个基于大型语言模型(LLM)的通用软件开发任务代理。它提供了一个强大的命令行界面(CLI),能够理解自然语言指令…

作者头像 李华
网站建设 2026/8/1 17:21:00

如何在8G显存上运行多模态AI:MiniCPM-Llama3-V 2.5完整部署指南

如何在8G显存上运行多模态AI:MiniCPM-Llama3-V 2.5完整部署指南 【免费下载链接】MiniCPM-Llama3-V-2_5-int4 项目地址: https://ai.gitcode.com/OpenBMB/MiniCPM-Llama3-V-2_5-int4 想要在普通电脑上体验GPT-4V级别的多模态AI吗?MiniCPM-Llama3…

作者头像 李华