处理接口幂等性的两种常见方案

接口幂等性处理算是一个非常常见的需求了,我们在很多项目中其实都会遇到。今天我们来看看两种比较简单的实现思路。

1. 接口幂等性实现方案梳理

其实接口幂等性的实现方案还是蛮多的,我这里和小伙伴们分享两种比较常见的方案。

1.1 基于 Token

基于 Token 这种方案的实现思路很简单,整个流程分两步:

  1. 客户端发送请求,从服务端获取一个 Token 令牌,每次请求获取到的都是一个全新的令牌。
  2. 客户端发送请求的时候,携带上第一步的令牌,处理请求之前,先校验令牌是否存在,当请求处理成功,就把令牌删除掉。

大致的思路就是上面这样,当然具体的实现则会复杂很多,有很多细节需要注意,松哥之前也专门录过这种方案的视频,小伙伴们可以参考下,录了两个视频,一个是基于拦截器处理的,还有一个是基于 AOP 切面处理的:

基于拦截器处理(视频一):

基于 AOP 切面处理(视频二):

1.2 基于请求参数校验

最近在 TienChin 项目中使用的是另外一种方案,这种方案是基于请求参数来判断的,如果在短时间内,同一个接口接收到的请求参数相同,那么就认为这是重复的请求,拒绝处理,大致上就是这么个思路。

相比于第一种方案,第二种方案相对来说省事一些,因为只有一次请求,不需要专门去服务端拿令牌。在高并发环境下这种方案优势比较明显。

所以今天我就来和大家聊聊第二种方案的实现,后面在 TienChin 项目视频中也会和大家细讲。

2. 基于请求参数的校验

首先我们新建一个 Spring Boot 项目,引入 Web 和 Redis 依赖,新建完成后,先来配置一下 Redis 的基本信息,如下:

spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=123
复制代码

为了后续 Redis 操作方便,我们再来对 Redis 进行一个简单封装,如下:

@Component
public class RedisCache {
    @Autowired
    public RedisTemplate redisTemplate;
    public <T> void setCacheObject(final String key, final T value, final Integer timeout, final TimeUnit timeUnit) {
        redisTemplate.opsForValue().set(key, value, timeout, timeUnit);
    }
    public <T> T getCacheObject(final String key) {
        ValueOperations<String, T> operation = redisTemplate.opsForValue();
        return operation.get(key);
    }
}
复制代码

这个比较简单,一个存数据,一个读数据。<

### 幂等性处理的解决方案 在现代软件开发中,接口幂等性设计至关重要。它能够确保即使客户端或服务端发生重试或其他异常情况,也不会因重复请求而导致数据错误或系统不稳定[^3]。 #### 1. 数据库唯一约束法 利用数据库中的唯一索引来防止重复记录插入是一种简单有效的幂等性控制方法。例如,在订单创建场景下,可以通过设置 `order_number` 字段为唯一键来避免重复下单: ```sql ALTER TABLE orders ADD UNIQUE (order_number); ``` 当尝试插入具有相同 `order_number` 的记录时,数据库会抛出唯一键冲突异常,从而阻止重复操作[^5]。 #### 2. 基于令牌的幂等性控制 另一种常见的方式是在每次请求时生成唯一的幂等令牌(Idempotency Token),并将该令牌存储到缓存或者数据库中。后续接收到相同的令牌时,则直接返回之前的结果而不执行实际业务逻辑。 以下是基于 Redis 缓存的一个示例实现: ```java import redis.clients.jedis.Jedis; public class IdempotentService { private Jedis jedis; public String processRequest(String idempotencyToken, String payload) throws Exception { if (jedis.exists(idempotencyToken)) { return jedis.get(idempotencyToken); // 返回已存在的响应结果 } else { try { // 模拟业务逻辑处理... String result = handleBusinessLogic(payload); // 存储当前请求及其对应的处理结果至Redis jedis.setex(idempotencyToken, 86400, result); // 设置过期时间为一天 return result; } catch (Exception e) { throw new RuntimeException("Failed to process request", e); } } } private String handleBusinessLogic(String payload) { // 实际业务逻辑代码省略 return "Success"; } } ``` 上述代码片段展示了如何通过 Redis 来保存和验证幂等令牌,以此达到幂等的效果。 #### 3. TCC模式下的幂等保障 对于复杂的分布式事务场景,采用Try-Confirm-Cancel(TCC)模式可以更好地支持幂等性需求。其中每个分支都需分别定义确认(Confirm)与取消(Cancel)两个补偿动作,并且这些动作本身也需要具备幂等特性[^4]。 比如在一个典型的转账案例里: - **Try**: 预留资金; - **Confirm**: 正式完成扣款; - **Cancel**: 取消预留并释放冻结金额; 所有这三个环节均应考虑其自身的幂等问题,以确保持久化层的数据一致性。 --- ### 总结 以上介绍了几种主流的幂等性设计方案,包括但不限于依赖数据库唯一约束、引入幂等token机制以及运用高级别的TCC架构等方式。每种技术都有各自适用范围及局限性,开发者应当依据具体应用场景灵活选用最合适的手段加以实施。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值