Spring Boot防重实战：Redis缓存+哈希锁方案性能测评

本文将介绍一种基于“哈希 + 缓存”双重防护机制的接口防重复提交方案，无需前端配合，不依赖额外 Token，仅通过请求特征动态生成哈希签名即可快速识别重复请求。我们将采用 Spring Boot + AOP + Redis/Caffeine 架构实现这一机制，整体方案轻量高效，具备实战级复用价值。

在高并发业务场景中，接口被重复点击或短时间内多次提交请求，是常见却极具破坏性的隐患。例如在电商系统中，用户多次点击“提交订单”按钮可能导致重复订单生成；支付接口被异常触发可能造成重复扣费；表单接口因网络波动被重复提交，极易产生脏数据。

这类问题虽看似小概率事件，但在真实生产环境中往往引发严重后果。为规避此类“重复提交”带来的混乱，我们需要在服务端层面构建一个高可靠的防重机制。

本方案通过构建全局唯一哈希值，结合动态缓存实现高效防重。当检测到相同哈希值在有效期内重复出现时，系统将自动拦截并返回提示，从源头杜绝数据异常。

防重原理与方案选型

什么是防重复提交

防重复提交（Prevent Duplicate Request）指防止用户在短时间内对同一接口重复触发操作，从而避免数据重复创建、状态异常或业务逻辑错误。

典型场景包括：

下单接口防止同一用户创建两笔相同订单；表单提交避免页面卡顿或多次点击产生重复记录；支付操作防止短时间内重复支付。

常见实现方式

本方案采用第三种方式，通过 URL + 请求方法 + 请求参数构建全局唯一哈希值，并将其存储在缓存中。当系统检测到相同哈希值在有效期内再次出现时，即判定为重复请求。

系统架构与流程设计

目录结构如下

/src 
├── /main
│   └── /java/com/icoderoad/duplicate
│       ├── annotation/PreventDuplicate.java
│       ├── aspect/PreventDuplicateAspect.java
│       ├── storage/DuplicateStorage.java
│       ├── storage/impl/RedisStorage.java
│       ├── storage/impl/CaffeineStorage.java
│       └── util/RequestParameterUtils.java
└── /resources
    └── application.yml

防重复机制核心流程如下：

请求进入控制层；AOP 拦截目标方法；提取 URL、请求方法、参数信息；计算 SHA-256 哈希值作为 Key；查询缓存是否存在该 Key；存在则拒绝请求，不存在则执行方法并写入缓存。

核心实现代码

自定义注解 @PreventDuplicate

package com.icoderoad.duplicate.annotation;

import java.lang.annotation.*;
import java.util.concurrent.TimeUnit;

/**
 * 防重复提交注解 
 * 可应用在 Controller 层接口上 
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PreventDuplicate {
    /** 防重复提交时间（单位：秒） */
    int expire() default 3;
    
    /** 时间单位，默认秒 */
    TimeUnit timeUnit() default TimeUnit.SECONDS;
    
    /** 可指定参与生成哈希的主要字段 */
    String[] field() default {};
    
    /** 提示信息 */
    String message() default "请勿重复提交！";
}

AOP 拦截器 PreventDuplicateAspect

package com.icoderoad.duplicate.aspect;

import cn.hutool.crypto.digest.DigestUtil;
import com.icoderoad.duplicate.annotation.PreventDuplicate;
import com.icoderoad.duplicate.storage.DuplicateStorage;
import com.icoderoad.duplicate.storage.DuplicateStorageFactory;
import com.icoderoad.duplicate.util.RequestParameterUtils;
import jakarta.servlet.http.HttpServletRequest;
import lombok.RequiredArgsConstructor;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.springframework.stereotype.Component;

@Aspect
@Component
@RequiredArgsConstructor
public class PreventDuplicateAspect {
    private final HttpServletRequest request;
    private final DuplicateStorageFactory storageFactory;
    
    @Around("@annotation(preventDuplicate)")
    public Object handle(ProceedingJoinPoint joinPoint, PreventDuplicate preventDuplicate) throws Throwable {
        String method = request.getMethod();
        String uri = request.getRequestURI();
        String params = RequestParameterUtils.getAllParamsAsString(joinPoint, preventDuplicate.field());
        
        // 拼接唯一签名源
        String signSource = method + ":" + uri + ":" + params;
        long start = System.currentTimeMillis();
        String key = DigestUtil.sha256Hex(signSource);
        long end = System.currentTimeMillis();
        System.out.println("生成哈希耗时：" + (end - start) + "ms");
        
        DuplicateStorage storage = storageFactory.getStorage();
        if (storage.exists(key)) {
            throw new RuntimeException(preventDuplicate.message());
        }
        storage.put(key, preventDuplicate.expire(), preventDuplicate.timeUnit());
        return joinPoint.proceed();
    }
}

控制层示例

package com.icoderoad.duplicate.controller;

import com.icoderoad.duplicate.annotation.PreventDuplicate;
import com.icoderoad.duplicate.model.ArticleDTO;
import com.icoderoad.duplicate.model.UserInfo;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/demo")
public class DemoController {
    @GetMapping("/hello")
    @PreventDuplicate
    public String hello(String name, String age, String address) {
        return "防重复测试：" + name + " " + age + " " + address;
    }
    
    @PostMapping("/saveUserInfo")
    @PreventDuplicate(expire = 5)
    public String saveUserInfo(@RequestBody UserInfo userInfo) {
        System.out.println(userInfo);
        return "请求时间：" + DateTime.now() + " 保存成功";
    }
    
    @PostMapping("/saveContent")
    @PreventDuplicate(expire = 10)
    public String saveContent(@RequestBody ArticleDTO articleDTO) {
        System.out.println(articleDTO);
        return "请求时间：" + DateTime.now() + " 内容保存成功";
    }
}

测试效果：当短时间内重复发送相同参数请求时，系统将直接返回"请勿重复提交！"异常提示。

性能验证

为验证哈希计算的性能表现，我们模拟生成一篇 3 万字文章内容并重复请求测试。测试数据表明：

首次生成哈希值耗时约9ms（JVM 预热阶段）；多次请求后平均耗时降至0ms；即使请求参数极大，对接口性能几乎无影响。

结论：SHA-256 哈希算法在防重场景中既具备唯一性又满足高性能要求，完全可支撑高并发接口的防重复需求。

总结与实践建议

通过本方案，我们实现了一个无侵入、通用性强、性能优越的防重复提交机制。核心优势体现在：

使用AOP 切面拦截请求，避免侵入业务逻辑；基于请求路径 + 方法 + 参数哈希生成唯一标识；通过Redis / Caffeine 缓存实现分布式与本地防重双模式；支持灵活配置提交间隔与关键字段粒度。

该方案不仅适用于表单、下单、支付等关键接口，还可扩展至异步任务提交、API 幂等控制等更广泛场景。

未来还可进一步优化：

加入异步清理机制；为Key 结构添加命名空间前缀；结合分布式锁提升集群环境下的安全性。

一句话总结：

防重不是“锦上添花”的优化，而是“防止灾难”的必要保护。用哈希 + 缓存双重保险，为你的接口上好“安全带”！