分布式系统的“稳定密码”——幂等性，你知道多少？

        在分布式系统中，确保操作的幂等性至关重要。幂等性意味着无论同一操作执行多少次，系统的状态和响应结果都应保持一致。本文将探讨幂等性的概念、应用场景，并详细介绍多种实现方案及其适用性。

什么是幂等性？

幂等性是指对同一操作进行多次执行，产生的结果与执行一次相同。换句话说，幂等操作具有以下特性：

•无副作用：多次执行不会产生额外的影响。

•结果一致：每次执行的结果相同。

在分布式系统中，由于网络延迟、超时或故障，可能导致同一请求被多次发送。因此，设计幂等性的接口可以防止数据重复处理，确保系统的稳定性和一致性。

---

幂等性的应用场景

幂等性在以下场景中尤为重要：

•支付处理：防止用户因网络问题重复提交支付请求，导致重复扣款。

•订单创建：确保同一订单不会被重复创建，避免库存和财务数据错误。

•消息队列消费：确保消息被消费一次，避免重复处理导致的数据不一致。

---

实现幂等性的方案

1. 前端控制重复提交

方法：

•禁用重复操作：在用户提交操作后，禁用提交按钮，防止用户重复点击。

•页面重定向：操作成功后，立即跳转到结果页面，避免用户通过浏览器的刷新或返回导致重复提交。

优缺点：

•优点：简单易行，减少了后端的处理压力。

•缺点：仅在客户端控制，无法防止恶意用户或网络问题导致的重复请求，可靠性较低。

2. 后端去重策略

a. 使用唯一业务标识

为每个业务操作生成唯一的业务标识（如订单号、事务ID），在处理请求时，通过该标识判断操作是否已执行。

实现步骤：

1.生成唯一标识：在请求中包含唯一的业务标识。

2.记录处理状态：后端在处理该请求前，检查该标识的处理状态。

3.判断并处理：如果该标识已处理，则直接返回结果；否则，执行操作并记录处理结果。

优缺点：

•优点：简单高效，适用于大多数业务场景。

•缺点：需要确保唯一标识的生成和传递，可能需要协调多个系统。

b. 数据库唯一约束

利用数据库的唯一约束，防止重复数据插入。

实现步骤：

1.设计唯一索引：在数据库表中，为需要幂等性的字段（如订单号）设置唯一索引。

2.插入数据：在插入数据时，如果违反唯一约束，则捕获异常并处理。

优缺点：

•优点：利用数据库特性，简单直接。

•缺点：可能导致数据库性能下降，尤其是在高并发场景下。

c. 乐观锁机制

通过在数据表中增加版本号或时间戳字段，实现乐观锁控制。

实现步骤：

1.读取数据：读取当前数据及其版本号。

2.更新数据：更新时，带上版本号，只有当版本号匹配时，更新才会成功。

3.处理冲突：如果更新失败，说明数据已被修改，需要重新读取并尝试更新。

优缺点：

•优点：无需加锁，性能较高。

•缺点：需要额外的字段支持，且在高并发下可能导致多次重试。

d. 分布式锁

在分布式系统中，使用分布式锁（如基于 Redis）来控制同一操作的并发执行。

实现步骤：

1.获取锁：在操作前，尝试获取分布式锁，锁的标识通常是业务唯一标识。

2.执行操作：获取锁成功后，执行操作。

3.释放锁：操作完成后，释放锁。

优缺点：

•优点：适用于高并发场景，控制粒度细。

•缺点：需要额外的分布式锁服务，增加了系统复杂度。

3. 缓存去重

利用缓存（如 Redis）存储已处理的请求标识，在处理请求前，先查询缓存，判断请求是否已处理。

实现步骤：

1.检查缓存：在处理请求前，查询缓存中是否存在该请求的唯一标识。

2.处理逻辑：如果存在，说明已处理，直接返回结果；如果不存在，执行操作并将标识存入缓存，设置适当的过期时间。

优缺点：

•优点：高效，适用于高并发场景。

•缺点：需要管理缓存的生命周期，防止内存溢出。

---

选择合适的幂等性方案

选择适合的幂等性方案需要根据具体的业务场景、系统架构和性能要求进行权衡。以下是一些建议：

•低并发、简单业务场景：前端控制或数据库唯一约束可能足够。

•高并发、复杂业务场景：考虑使用分布式锁、缓存去重或唯一业务标识等方案。

•需要高性能且允许一定程度的重复：乐观锁可能是一个折中的选择。

---

实战代码

在分布式系统中，确保操作的幂等性至关重要。以下将以Spring Boot框架为例，展示如何设计并实现一个具备幂等性的订单创建接口。

项目结构

假设我们的项目名为idempotency-demo，其基本结构如下：

idempotency-demo
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           └── idempotency
│   │   │               ├── IdempotencyDemoApplication.java
│   │   │               ├── config
│   │   │               │   └── RedisConfig.java
│   │   │               ├── controller
│   │   │               │   └── OrderController.java
│   │   │               ├── model
│   │   │               │   └── OrderRequest.java
│   │   │               ├── service
│   │   │               │   └── OrderService.java
│   │   │               └── util
│   │   │                   └── IdempotencyKeyGenerator.java
│   │   └── resources
│   │       ├── application.properties
│   │       └── templates
│   └── test
│       └── java
│           └── com
│               └── example
│                   └── idempotency
│                       └── IdempotencyDemoApplicationTests.java
└── pom.xml

1. pom.xml 配置

首先，定义项目的Maven依赖：

    4.0.0

    com.example
    idempotency-demo
    0.0.1-SNAPSHOT
    idempotency-demo

    
        org.springframework.boot
        spring-boot-starter-parent
        2.5.4
         
    

    
        11
    

    
        
        
            org.springframework.boot
            spring-boot-starter-web
        

        
        
            org.springframework.boot
            spring-boot-starter-data-redis
        

        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        

        
        
            org.projectlombok
            lombok
            true
        
    

    
        
            
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

2. 配置类

在com.example.idempotency.config包中创建RedisConfig.java，配置Redis模板：

package com.example.idempotency.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.lettuce.LettuceConnectionFactory;
import org.springframework.data.redis.core.StringRedisTemplate;

@Configuration
public class RedisConfig {

    @Bean
    public StringRedisTemplate stringRedisTemplate(LettuceConnectionFactory connectionFactory) {
        return new StringRedisTemplate(connectionFactory);
    }
}

3. 业务代码

3.1 幂等性键生成工具类

在com.example.idempotency.util包中创建IdempotencyKeyGenerator.java，用于生成幂等性键：

package com.example.idempotency.util;

import org.springframework.util.DigestUtils;

public class IdempotencyKeyGenerator {

    public static String generateKey(String userId, String payload) {
        String combined = userId + ":" + payload;
        return DigestUtils.md5DigestAsHex(combined.getBytes());
    }
}

3.2 订单请求模型

在com.example.idempotency.model包中创建OrderRequest.java，表示订单请求的数据模型：

package com.example.idempotency.model;

import lombok.Data;

@Data
public class OrderRequest {
    private String productId;
    private int quantity;
    // 其他订单相关字段
}

3.3 订单服务类

在com.example.idempotency.service包中创建OrderService.java，处理订单创建逻辑：

package com.example.idempotency.service;

import com.example.idempotency.model.OrderRequest;
import org.springframework.stereotype.Service;

@Service
public class OrderService {

    public String createOrder(OrderRequest orderRequest) {
        // 实际的订单创建逻辑，例如保存到数据库
        // 这里简化为返回一个订单ID
        return "ORDER_" + System.currentTimeMillis();
    }
}

3.4 订单控制器

在com.example.idempotency.controller包中创建OrderController.java，处理订单创建的HTTP请求，并实现幂等性控制：

package com.example.idempotency.controller;

import com.example.idempotency.model.OrderRequest;
import com.example.idempotency.service.OrderService;
import com.example.idempotency.util.IdempotencyKeyGenerator;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.concurrent.TimeUnit;

@RestController
@RequestMapping("/orders")
public class OrderController {

    @Autowired
    private StringRedisTemplate redisTemplate;

    @Autowired
    private OrderService orderService;

    @PostMapping
    public ResponseEntity createOrder(@RequestBody OrderRequest orderRequest, @RequestHeader("Idempotency-Key") String idempotencyKey) {
        // 检查幂等性键是否已存在
        Boolean exists = redisTemplate.hasKey(idempotencyKey);
        if (Boolean.TRUE.equals(exists)) {
            return ResponseEntity.status(409).body("Duplicate request");
        }

        // 设置幂等性键，防止重复提交
        redisTemplate.opsForValue().set(idempotencyKey, "IN_PROGRESS", 10, TimeUnit.MINUTES);

        try {
            // 执行订单创建逻辑
            String orderId = orderService.createOrder(orderRequest);
            // 操作成功，更新幂等性键的状态
            redisTemplate.opsForValue().set(idempotencyKey, "COMPLETED", 10, TimeUnit.MINUTES);
            return ResponseEntity.ok(orderId);
        } catch (Exception e) {
            // 操作失败，删除幂等性键
            redisTemplate.delete(idempotencyKey);
            return ResponseEntity.status(500).body("Order creation failed");
        }
    }
}

说明：

•幂等性键的生成与传递：客户端在每次请求时生成唯一的Idempotency-Key，并在HTTP请求头中传递给服务器。服务器使用该键来判断请求是否已被处理。

•检查幂等性键：在处理请求前，首先检查Redis中是否已存在该幂等性键。如果存在，说明该请求已被处理，返回409冲突状态码。

•设置幂等性键：如果幂等性键不存在，则在Redis中设置该键，值为IN_PROGRESS，并设置过期时间为10分钟，防止长期占用内存。

•执行订单创建逻辑：调用OrderService的createOrder方法处理订单创建。

•更新或删除幂等性键：如果订单创建成功，更新Redis中幂等性键的值为COMPLETED；如果失败，删除该键。

通过上述实现，确保了在高并发场景下，订单创建接口的幂等性，防止重复提交导致的数据不一致问题。

结语

幂等性是分布式系统设计中的关键概念，确保操作的幂等性可以提高系统的可靠性和一致性。通过结合业务需求，选择合适的幂等性方案，可以有效防止重复操作带来的问题，提升用户体验和系统稳定性。

开源一个纯AI生成的健身记录App，如需源码，可关注公众号：小健学Java，回复“健身”即可获得！

如需Java面试题资料，可关注公众号：小健学Java，回复“面试”即可获得！