1. 为什么我们需要防止表单重复提交在Web开发中表单重复提交是一个常见但容易被忽视的问题。想象一下这样的场景用户在电商网站点击提交订单按钮后由于网络延迟或页面响应慢用户可能会多次点击同一个按钮导致同一个订单被重复创建。这不仅会造成数据混乱还可能引发财务问题。表单重复提交通常发生在以下几种情况用户快速多次点击提交按钮页面提交后刷新提交后点击浏览器后退按钮再次提交网络延迟导致用户误以为提交失败而重试在传统的Java Web应用中我们可能会在服务端使用Token机制来防止重复提交但在Spring Boot中我们可以通过更优雅的方式——自定义注解来实现这一功能。2. 自定义注解的核心设计思路2.1 注解的基本概念在Java中注解Annotation是一种元数据形式它提供了一种向代码添加元信息的方式。Spring框架大量使用了注解来简化配置和实现各种功能。自定义注解的核心优势在于声明式编程通过简单的注解标记就能实现复杂功能代码解耦业务逻辑与防重提交逻辑分离可重用性一次开发多处使用2.2 防重提交注解的设计我们需要设计的防重提交注解NoRepeatSubmit应该包含以下特性可以标记在Controller方法上能够设置锁的过期时间支持自定义错误消息能够区分不同用户的请求注解的初步设计如下Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface NoRepeatSubmit { /** * 锁的过期时间默认5秒 */ int lockTime() default 5; /** * 自定义错误消息 */ String message() default 请勿重复提交; }3. 实现防重提交的核心组件3.1 分布式锁的选择与实现在分布式环境下我们需要一个可靠的锁机制来防止重复提交。Redis是一个理想的选择因为它性能高支持原子操作可以设置过期时间在分布式环境中表现良好我们使用Spring Data Redis来实现Redis锁Component public class RedisLock { Autowired private StringRedisTemplate stringRedisTemplate; /** * 尝试获取锁 * param key 锁的key * param value 锁的value * param expire 过期时间(秒) * return 是否获取成功 */ public boolean tryLock(String key, String value, int expire) { Boolean result stringRedisTemplate.opsForValue() .setIfAbsent(key, value, expire, TimeUnit.SECONDS); return Boolean.TRUE.equals(result); } /** * 释放锁 * param key 锁的key * param value 锁的value */ public void unlock(String key, String value) { String currentValue stringRedisTemplate.opsForValue().get(key); if (currentValue ! null currentValue.equals(value)) { stringRedisTemplate.delete(key); } } }3.2 拦截器的实现我们需要一个拦截器来拦截带有NoRepeatSubmit注解的方法Component public class NoRepeatSubmitInterceptor implements HandlerInterceptor { Autowired private RedisLock redisLock; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (handler instanceof HandlerMethod) { HandlerMethod handlerMethod (HandlerMethod) handler; NoRepeatSubmit noRepeatSubmit handlerMethod.getMethodAnnotation(NoRepeatSubmit.class); if (noRepeatSubmit ! null) { String userId getUserId(request); // 获取用户ID的方法 String requestURI request.getRequestURI(); String key no_repeat_submit: userId : requestURI; String value UUID.randomUUID().toString(); if (!redisLock.tryLock(key, value, noRepeatSubmit.lockTime())) { throw new RuntimeException(noRepeatSubmit.message()); } request.setAttribute(no_repeat_submit_key, key); request.setAttribute(no_repeat_submit_value, value); } } return true; } Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { if (handler instanceof HandlerMethod) { HandlerMethod handlerMethod (HandlerMethod) handler; NoRepeatSubmit noRepeatSubmit handlerMethod.getMethodAnnotation(NoRepeatSubmit.class); if (noRepeatSubmit ! null) { String key (String) request.getAttribute(no_repeat_submit_key); String value (String) request.getAttribute(no_repeat_submit_value); if (key ! null value ! null) { redisLock.unlock(key, value); } } } } private String getUserId(HttpServletRequest request) { // 实际项目中可以从session或token中获取用户ID // 这里简化处理返回固定值 return user1; } }3.3 注册拦截器为了让拦截器生效我们需要在Spring Boot配置中注册它Configuration public class WebConfig implements WebMvcConfigurer { Autowired private NoRepeatSubmitInterceptor noRepeatSubmitInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(noRepeatSubmitInterceptor) .addPathPatterns(/**); } }4. 实际应用与测试4.1 在Controller中使用注解现在我们可以在任何需要防止重复提交的Controller方法上使用NoRepeatSubmit注解RestController RequestMapping(/order) public class OrderController { PostMapping(/create) NoRepeatSubmit(lockTime 10, message 订单正在处理中请勿重复提交) public ResponseEntityString createOrder(RequestBody OrderDTO orderDTO) { // 模拟业务处理时间 try { Thread.sleep(3000); } catch (InterruptedException e) { Thread.currentThread().interrupt(); } return ResponseEntity.ok(订单创建成功); } }4.2 测试防重提交功能我们可以使用Postman或curl命令来测试这个功能第一次发送请求成功创建订单在10秒内我们设置的lockTime再次发送相同请求会收到订单正在处理中请勿重复提交的错误10秒后再次发送请求可以成功创建新订单4.3 前端配合实现虽然服务端已经实现了防重提交但为了更好的用户体验前端也应该做一些处理提交按钮点击后禁用显示加载状态请求完成后才恢复按钮状态示例前端代码使用jQuery$(#submitBtn).click(function() { var $btn $(this); $btn.prop(disabled, true); $btn.text(处理中...); $.ajax({ url: /order/create, method: POST, data: JSON.stringify(orderData), contentType: application/json, success: function(response) { alert(订单创建成功); }, error: function(xhr) { alert(xhr.responseText); }, complete: function() { $btn.prop(disabled, false); $btn.text(提交订单); } }); });5. 进阶优化与注意事项5.1 锁粒度的优化我们当前的实现是以用户ID请求URI作为锁的key这在大多数情况下已经足够。但在某些特殊场景下可能需要更细粒度的控制。例如对于同一个用户对同一个商品多次下单的情况可以在key中加入商品IDString productId orderDTO.getProductId(); String key no_repeat_submit: userId : productId;对于需要区分参数的场景可以计算参数的MD5作为key的一部分String paramsJson objectMapper.writeValueAsString(orderDTO); String paramsHash DigestUtils.md5DigestAsHex(paramsJson.getBytes()); String key no_repeat_submit: userId : requestURI : paramsHash;5.2 异常处理与事务回滚在实际项目中我们需要考虑异常情况下的处理如果业务逻辑抛出异常应该确保锁被正确释放PostMapping(/create) NoRepeatSubmit public ResponseEntityString createOrder(RequestBody OrderDTO orderDTO) { try { // 业务逻辑 return ResponseEntity.ok(成功); } catch (Exception e) { // 记录日志等 throw e; // 抛出异常让拦截器处理锁释放 } }如果使用数据库事务需要注意锁的释放时机Transactional PostMapping(/create) NoRepeatSubmit public ResponseEntityString createOrder(RequestBody OrderDTO orderDTO) { // 业务逻辑 return ResponseEntity.ok(成功); }在这种情况下拦截器的afterCompletion方法会在事务提交后执行这是合理的。但如果希望在事务回滚时也释放锁可以使用TransactionalEventListener监听事务事件。5.3 性能考虑在高并发场景下防重提交机制可能会成为性能瓶颈。我们可以考虑以下优化使用本地缓存作为第一层防护Redis作为第二层防护public boolean tryLock(String key, String value, int expire) { // 先检查本地缓存 if (localCache.getIfPresent(key) ! null) { return false; } // 再检查Redis Boolean result stringRedisTemplate.opsForValue() .setIfAbsent(key, value, expire, TimeUnit.SECONDS); if (Boolean.TRUE.equals(result)) { localCache.put(key, value); } return Boolean.TRUE.equals(result); }对于特别高频的接口可以考虑使用更轻量级的锁实现如基于内存的RateLimiter。5.4 测试注意事项在测试防重提交功能时需要注意以下几点并发测试使用JMeter等工具模拟多用户并发提交网络延迟测试模拟慢速网络环境下的多次提交分布式测试在多个服务实例上测试锁的有效性异常测试测试在服务重启、Redis宕机等情况下的行为6. 替代方案比较除了自定义注解的方式还有其他几种常见的防重提交方案6.1 前端Token方案原理服务端生成唯一Token并存储在Session中页面加载时将Token作为隐藏字段提交时带上Token服务端验证后删除Token优点实现简单不依赖外部存储缺点无法防止恶意绕过前端的重复提交在分布式环境下需要额外处理Session共享6.2 数据库唯一索引原理为业务表添加唯一索引重复提交时会抛出唯一约束异常优点实现简单绝对可靠缺点只适用于有唯一业务键的场景数据库压力大不友好的错误提示6.3 请求指纹方案原理计算请求参数用户标识的指纹短时间内相同指纹的请求视为重复优点可以防止参数相同的重复提交粒度更细缺点计算指纹有性能开销对于大请求体不友好相比之下我们的自定义注解方案结合了Redis分布式锁的优势既保证了分布式环境下的可靠性又通过注解实现了声明式编程是较为理想的解决方案。
企业数字化 ERP 产品动态
相关推荐
程序员常见错误分类与高效调试指南 1. 错误大全:程序员必备的避坑指南在编程这条路上,我们每个人都是踩着错误成长起来的。记得刚入行时,我花了整整三天时间排查一个简单的空指针异常,那种挫败感至今难忘。正是这些痛苦的经历让我意识到:错误不是敌人&am… · 2026/11/6 2:20:09
HTTP状态码详解:分类、应用与最佳实践 1. HTTP状态码基础概念与分类体系 HTTP状态码是服务器对客户端请求的响应标识,由三位数字和描述性短语组成。这些代码不仅告知请求是否成功,更精确指示了请求处理过程中的各类状态。根据RFC 7231规范,状态码被系统性地划分为五个类别… · 2026/11/19 13:58:43
深圳考电工证资料怎么转到本地?全国通用的证书怎么操作 深圳考电工证资料怎么转到本地?全国通用的证书怎么操作 之前考的证在外省能不能转过来?这是很多在深圳打工的电工兄弟最关心的问题,特别是那些在外地考了证,现在在深圳工作的朋友。好在,现在的 深圳考电工证资料 在全国范围内 全国通用… · 2026/11/21 4:36:53
焦作高级电工证报名别怕挂科,郑州报考避坑指南全在这里 焦作高级电工证报名别怕挂科,郑州报考避坑指南全在这里 实操考试心里没底怕挂科,这几乎是每个准备报考焦作高级电工证的朋友都有的顾虑。别急,这波郑州报考避坑指南,专为你们量身打造。从材料准备到考试技巧,从培训机构选择到继续教育规定,我一个干了1… · 2026/11/21 4:36:53
电工证考试济南哪里考 你还在为特种作业证含金量发愁吗 电工证考试济南哪里考 你还在为特种作业证含金量发愁吗 你是不是正被“急需特种作业证才能上岗找工作”的压力逼得喘不过气?现在不少建筑工地、制造业企业都明确规定,没有电工证、焊工证、高处作业证这些特种作业证,连门都进不了。更别提这些证书的… · 2026/11/21 4:36:53
广工特种加工研究与你在哪里考特种作业证的全部干货 广工特种加工研究与你在哪里考特种作业证的全部干货 你是不是学历不高,怕报不了名?其实很多人担心自己没学历,连特种作业证都考不了,但现实是, 特种作业证报考并不看重学历,关键在技能和考试成绩 。而你最关心的问题是—— 广工特种加工研究… · 2026/11/21 4:36:53
电工证包含登高证么?多少钱?工地太忙根本没时间复习考试 电工证包含登高证么?多少钱?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这几乎是每个电工从业者的切身感受。尤其是那些在建筑、电力、安装等一线岗位上的工人,每天要赶工期、抢进度,根本腾不出时间去准备考试。你可能还担心:… · 2026/11/21 4:35:52
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32
电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17
房建企业特种工考前押题怎么找?别让培训费打了水漂 房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03