百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术资源 > 正文

什么是接口幂等性?为什么会产生这个问题?如何保证接口幂等性?

off999 2025-03-20 17:39 36 浏览 0 评论

之前负责的项目报了一个问题,用户操作回退失效。我们的设计里,操作回退是回到操作前的状态。经过查看日志发现,用户之前的操作做了两次,也就是说提交操作的接口被调用了两次,导致之用户上一次的状态和这一次的状态是一样的,所以操作回退是没有问题的,问题出在了操作的接口被调用了两次。

对于防止重复提交,是放在前端控制的,用户点击完按钮之后,后台返回成功的结果,按钮就不可见,实践证明,客户端的限制操作不是绝对可靠的。

针对上面的场景,就引入了今天的问题,什么是接口幂等性?如何保证接口幂等性?

什么是接口幂等性?

首先看看幂等性的概念:

幂等性原本是数学上的概念,用在接口上就可以理解为:同一个接口,多次发出同一个请求,必须保证操作只执行一次。 调用接口发生异常并且重复尝试时,总是会造成系统所无法承受的损失,所以必须阻止这种现象的发生。

比如下面这些情况,如果没有实现接口幂等性会有很严重的后果: 支付接口,重复支付会导致多次扣钱 ;订单接口,同一个订单可能会多次创建。

为什么会产生接口幂等性问题?

那么,什么情况下,会产生接口幂等性的问题呢?

  • 网络波动, 可能会引起重复请求
  • 用户重复操作,用户在操作时候可能会无意触发多次下单交易,甚至没有响应而有意触发多次交易应用
  • 使用了失效或超时重试机制(Nginx重试、RPC重试或业务层重试等)
  • 页面重复刷新
  • 使用浏览器后退按钮重复之前的操作,导致重复提交表单
  • 使用浏览器历史记录重复提交表单
  • 浏览器重复的HTTP请求
  • 定时任务重复执行
  • 用户双击提交按钮

如何保证接口幂等性?

那么最关键的来了,如何保证接口幂等性?

解决办法分为两个方向,一个方向是客户端防止重复调用,一个是服务端进行校验。当然,客户端防止重复提交并不是绝对可靠的,优点是实现起来比较简单。

  1. 按钮只可操作一次

一般是提交后把按钮置或loding状态,消除用户因为重复点击而产生的重复记录,比如添加操作,由于点击两次而产生两条记录

  1. token机制

功能上允许重复提交,但要保证重复提交不产生副作用,比如点击n次只产生一条记录,具体实现就是进入页面时申请一个token,然后后面所有的请求都带上这个token,后端根据token来避免重复请求。

  1. 使用Post/Redirect/Get模式

在提交后执行页面重定向,这就是所谓的Post-Redirect—Get(PRG)模式,简单来说就是当用户提交连表单后,跳转到一个重定向的信息页面,这样就避免用户按F5刷新导致的重复提交,而且也不会出现浏览器表单重复提交的警告,也能消除按浏览器前进和后退导致同样重复提交的问题。

  1. 在session存放特殊标志

在服务端,生成一个唯一的标识符,将它存入session,同时前端获取这个标识符的值将它写入表单的隐藏中,用于用户输入信息后点击一起提交,在服务器端,获取表单中隐藏字段的值,与session中的唯一标识符比较,相等说明是首次提交,就处理本次请求,然后将session中的唯一标识符移除,不相等则表示是重复提交,不再做处理。

  1. 使用唯一索引防止新增脏数据

利用数据库唯一索引机制,当数据重复时,插入数据库会抛出异常,保证不会出现脏数据。

  1. 乐观锁

如果更新已有数据,可以进行加锁更新,也可以设计表结构时使用乐观锁,通过version来做乐观锁,这样既能保证执行效率,又能保证幂等, 乐观锁的version版本在更新业务数据要自增
update table set version = version + 1 where id = #{id} and version = #{version}
示例: 当有重复请求的时候,第一个请求会获取当前商品的version版本号,得到的version为1,紧接着由于第一个请求还没更新商品的version,第二个请求获取的version依然也是1, 这时候第一个请求操作更新的时候带上version并作为条件并且
自增更新,这时候商品的version就会变成2,当第二个请求去操作更新的时候明显version不一致导致更新失败。

  1. select + insert or update or delete

该方案就是操作之前先查询一下,符合要求再插入,该方案在没有并发的系统中可以解决幂等问题,在单JVM有并发的时候可以用JVM加锁来保证幂等性,在分布式环境它是无法保证幂等性,可以使用分布式来保证。

  1. 分布式锁

如果是分布是系统,构建全局唯一索引比较困难,例如唯一性的字段没法确定,这时候可以引入分布式锁,通过第三方的系统(redis或zookeeper),在业务系统插入数据或者更新数据,获取分布式锁,然后做操作,之后释放锁,这样其实是把多线程并发的锁的思路,引入多多个系统,也就是分布式系统中得解决思路。要点:某个长流程处理过程要求不能并发执行,可以在流程执行之前根据某个标志(用户ID+后缀等)获取分布式锁,其他流程执行时获取锁就会失败,也就是同一时间该流程只能有一个能执行成功,执行完成后,释放分布式锁(分布式锁要第三方系统提供)。

  1. 状态机幂等

在设计单据相关的业务,或者是任务相关的业务,肯定会涉及到状态机(状态变更图),就是业务单据上面有个状态,状态在不同的情况下会发生变更,一般情况下存在有限状态机,这时候,如果状态机已经处于下一个状态,这时候来了一个上一个状态的变更,理论上是不能够变更的,这样的话,保证了有限状态机的幂等。注意:订单等单据类业务,存在很长的状态流转,一定要深刻理解状态机,对业务系统设计能力提高有很大帮助 。

  1. 防重表

以支付为例: 使用唯一主键去做防重表的唯一索引,比如使用订单号作为防重表的唯一索引,每一次请求都根据订单号向防重表中插入一条数据,插入成功说明可以处理后面的业务,当处理完业务逻辑之后删除防重表中的订单号数据,后续如果有重复请求,则会因为防重表唯一索引原因导致插入失败,直接返回操作失败,直到第一次请求返回结果,可以看出防重表作用就是加锁的功能。
注: 最好结合状态机幂等先判断一下

  1. 缓冲队列

将请求都快速地接收下来后放入缓冲队列中,后续使用异步任务处理队列中的数据,过滤掉重复的请求,该解决方案优点是同步处理改成异步处理、高吞吐量,缺点则是不能及时地返回请求结果,需要后续轮询得处理结果。

  1. 全局唯一号

比如通过source来源 + 唯一序列号传入给后端,后端来判断请求是否重复,在并发时只能处理一个请求,其他相同并发请求要么返回请求重复,要么等待 前面请求执行完成后再执行。

作者:三分恶

原文链接:
https://www.cnblogs.com/three-fighter/p/14054749.html

相关推荐

win7安装需要标准nvm(安装win7要求)

1、把操作系统的安装镜像用WINRAR软件全部解压。2、找一个U盘,不小于8GB,格式化为FAT32格式,把上一步解压的文件复制到U盘中。3、重启电脑,按F12,选择电脑当前从U盘启动,进可以进入安装...

win10不兼容32位软件(win10系统不兼容软件)

使用电脑管家更新下驱动就可以了。1、打开腾讯电脑管家,点击“工具箱”。2、在工具箱里找到“硬件检测”。3、在硬件检测里点击“驱动安装”。4、可以看到“安装状态”,如果是未安装可以直接点击安装。首先你...

win7的屏保设置在哪里(win7 如何设置屏保)

要设置屏保,按照以下步骤进行操作:1.点击桌面上空白处右键,选择“个性化”。2.在个性化窗口中,点击左侧菜单栏中的“屏幕保护程序”选项。3.在“屏幕保护程序”窗口中,可以选择系统提供的屏保样式。...

电脑重新分区后如何恢复数据

如果电脑从新分区后没有进行数据覆盖,那么数据恢复的可能性是存在的。但是需要注意的是,分区操作本身就会对硬盘进行一定程度的数据覆盖,因此恢复成功的可能性会受到影响。如果您需要恢复分区后的数据,可以尝试使...

手机连接电脑没反应只能充电

手机连接到电脑上,只显示充电状态,可能有以下原因。1.使用的USB线只是充电线。可以更换USB数据线。2.手机的USB连接,设置为仅充电了。设置为数据传输就行了。3.电脑中缺少手机使用的USB驱动。可...

百度手机卫士官网(百度手机卫士官网个人中心)

百度卫士  百度卫士是百度公司全新出品的简单可信赖的系统工具软件,集合了电脑加速、系统清理、木马查杀和软件管理功能,竭力为用户提供轻巧、快速、智能、纯净的产品体验。百度卫士郑重承诺:永久免费、不骚扰...

怎么自己安装win10系统(怎么自己安装win10系统)

 WindowS10安装系统教程方法很简单,建议使用U盘启动盘安装方法,找到一个8g的U盘,用老毛桃或大白菜启动程序制作成启动盘,将windowS10操作系统传入U盘内,插在电脑USB接...

win7升级win10需要产品密钥(windows7升级10要激活码吗)

1、通过win+R打开“运行”窗口,输入“cmd”打开命令提示窗口,输入slmgr/upk,卸载当初前操作系统密钥;  2、打开当前操作系统“系统盘”找内到“ESD”(升级助手缓存的windows...

华硕声卡驱动下载官网(华硕官方声卡驱动)

如果华硕笔记本声卡驱动消失了,可以尝试以下方法进行修复。首先,进入设备管理器,检查是否存在声卡设备,并进行更新驱动。如果没有找到声卡设备,可以在华硕官方网站上搜索相应型号的声卡驱动程序,并下载安装最新...

sd卡低级格式化(格式化 sd卡)

1.首先将装有内存卡的读卡器插到电脑主机USB接口中。2.接着点这里下载【内存卡低格工具llftool】工具。3.下载完成后,对其进行解压缩,然后双击运行其中的可执行程序。4.在打开的修复程序窗口中,...

怎么把一个u盘做成2个系统盘

1、U盘插入电脑,鼠标右键点击桌面的“此电脑”,选择管理。2、然后再选择“磁盘管理”。3、找到U盘的两个分区,选择一个不需要的分区,鼠标右键点击这个分区选择“删除卷”。4、删除完之后会出现一个未分配的...

华硕bios恢复出厂设置图解(华硕bios恢复出厂设置步骤)
华硕bios恢复出厂设置图解(华硕bios恢复出厂设置步骤)

可能有些人会不知道华硕笔记本怎么恢复出厂设置,现在给你们说说:华硕笔记本开机点击F2键即可进入BIOS界面,华硕主板可开机后点击DEL键进入BIOS界面。进入BIOS界面后,可通过以下两种方式恢复BIOS出厂设置:1、点击F9键后会出现以下...

2025-12-22 11:51 off999

平板电脑选择(平板电脑选择256还是512)

当选择平板电脑的存储容量时,以下是一些更具体的考虑因素:1.多媒体使用:如果你经常使用平板观看高清视频、存储大量照片或下载大型游戏,那么512GB的存储容量可能更适合你。这样你就可以存储更多的媒体文...

电脑主板天梯图2025最新版(主板天梯图2021最新)

笔记本电脑CPU天梯图,笔记本电脑CPU排行,是按照CPU的跑分进行排序,进行综合性能对比。可以一定程度上反应CPU的性能优劣,方便进行笔记本电脑CPU对比。2019年的CPU天梯图,基本是Intel...

电脑看视频一卡一卡的是什么原因

回答如下:可能是以下原因导致的:1.网络带宽不足:如果您的网络速度不够快,视频会一卡一卡的,因为您的电脑需要等待缓冲完成才能播放下一段视频。2.视频格式不受支持:如果您的电脑不支持视频格式,视频可...

取消回复欢迎 发表评论: