【详解】SpringMVC防止重复提交表单的方法

举报
皮牙子抓饭 发表于 2025/06/10 20:25:17 2025/06/10
【摘要】 SpringMVC防止重复提交表单的方法在Web开发中，防止表单重复提交是一个常见的需求。用户可能因为网络延迟、页面刷新或多次点击提交按钮等原因，导致同一个表单被多次提交，这可能会引发数据不一致或其他问题。本文将介绍几种在SpringMVC框架中防止表单重复提交的有效方法。1. 使用Token机制原理Token机制是防止表单重复提交的一种常用方法。服务器生成一个唯一的Token，并将其嵌入到...

SpringMVC防止重复提交表单的方法

在Web开发中，防止表单重复提交是一个常见的需求。用户可能因为网络延迟、页面刷新或多次点击提交按钮等原因，导致同一个表单被多次提交，这可能会引发数据不一致或其他问题。本文将介绍几种在SpringMVC框架中防止表单重复提交的有效方法。

1. 使用Token机制

原理

Token机制是防止表单重复提交的一种常用方法。服务器生成一个唯一的Token，并将其嵌入到表单中。当用户提交表单时，这个Token会被一起发送到服务器。服务器端会验证这个Token的有效性，如果有效则处理请求并删除或标记该Token为已使用；如果无效，则拒绝请求。

实现步骤

  1. 生成Token：在用户访问表单页面时，服务器生成一个唯一的Token，并存储在Session中。
  2. 嵌入Token：将生成的Token嵌入到表单的隐藏字段中。
  3. 验证Token：在表单提交时，服务器端验证表单中的Token是否与Session中的Token一致，且未被使用过。
  4. 处理Token：如果Token验证通过，处理表单数据，并从Session中移除或标记该Token为已使用。

示例代码

控制器
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

import javax.servlet.http.HttpSession;
import java.util.UUID;

@Controller
public class FormController {

    @GetMapping("/form")
    public String showForm(HttpSession session, Model model) {
        String token = UUID.randomUUID().toString();
        session.setAttribute("token", token);
        model.addAttribute("token", token);
        return "form";
    }

    @PostMapping("/submit")
    public String submitForm(@RequestParam("token") String token, HttpSession session) {
        String sessionToken = (String) session.getAttribute("token");
        if (sessionToken != null && sessionToken.equals(token)) {
            session.removeAttribute("token");
            // 处理表单数据
            return "success";
        } else {
            return "error";
        }
    }
}
表单页面（form.html）
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Form</title>
</head>
<body>
<form th:action="@{/submit}" method="post">
    <input type="hidden" name="token" th:value="${token}">
    <label for="name">Name:</label>
    <input type="text" id="name" name="name">
    <button type="submit">Submit</button>
</form>
</body>
</html>

2. 使用JavaScript禁用提交按钮

原理

通过JavaScript在用户点击提交按钮后立即禁用该按钮，防止用户多次点击提交。

实现步骤

  1. 添加JavaScript代码：在表单页面中添加JavaScript代码，监听提交按钮的点击事件。
  2. 禁用按钮：在点击事件中禁用提交按钮。

示例代码

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Form</title>
    <script>
        function disableButton() {
            document.getElementById('submitBtn').disabled = true;
        }
    </script>
</head>
<body>
<form th:action="@{/submit}" method="post" onsubmit="disableButton()">
    <label for="name">Name:</label>
    <input type="text" id="name" name="name">
    <button type="submit" id="submitBtn">Submit</button>
</form>
</body>
</html>

3. 使用SpringMVC的​​@SessionAttributes​​注解

原理

通过​​@SessionAttributes​​注解将表单数据存储在Session中，每次提交表单时检查Session中是否存在该数据，如果存在则拒绝处理。

实现步骤

  1. 标注控制器：在控制器类上使用​​@SessionAttributes​​注解，指定需要存储在Session中的属性。
  2. 检查Session：在处理表单提交的方法中，检查Session中是否已经存在该属性。

示例代码

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.SessionAttributes;

@Controller
@SessionAttributes("formData")
public class FormController {

    @GetMapping("/form")
    public String showForm(Model model) {
        model.addAttribute("formData", new FormData());
        return "form";
    }

    @PostMapping("/submit")
    public String submitForm(FormData formData, BindingResult result, Model model) {
        if (model.containsAttribute("formData")) {
            // 表单数据已存在，拒绝处理
            return "error";
        }
        // 处理表单数据
        model.addAttribute("formData", formData);
        return "success";
    }
}

class FormData {
    private String name;

    // getters and setters
}


防止表单重复提交是Web开发中一个重要的问题，本文介绍了三种在SpringMVC框架中实现这一功能的方法：

  1. 使用Token机制。
  2. 使用JavaScript禁用提交按钮。
  3. 使用SpringMVC的​​@SessionAttributes​​注解。

在Web开发中，防止表单重复提交是一个常见的需求，尤其是在处理敏感操作如订单提交、用户注册等场景时尤为重要。Spring MVC提供了多种方法来防止表单重复提交，下面我将介绍几种常用的方法，并提供相应的示例代码。

方法一：使用Token（令牌）

  1. 生成Token：在用户访问表单页面时生成一个唯一的Token，并将其存储在Session中。
  2. 验证Token：在表单提交时，将Token作为隐藏字段传递到服务器端进行验证，如果验证通过，则处理表单数据并从Session中移除该Token；如果验证不通过或Token已不存在，则拒绝处理表单数据。
示例代码

Controller代码：

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

import javax.servlet.http.HttpSession;
import java.util.UUID;

@Controller
public class FormController {

    @GetMapping("/form")
    public String showForm(Model model, HttpSession session) {
        // 生成Token
        String token = UUID.randomUUID().toString();
        session.setAttribute("token", token);
        model.addAttribute("token", token);
        return "form";
    }

    @PostMapping("/submit")
    public String submitForm(@RequestParam("token") String clientToken, HttpSession session) {
        // 获取Session中的Token
        String serverToken = (String) session.getAttribute("token");
        
        if (serverToken != null && serverToken.equals(clientToken)) {
            // Token验证通过，处理表单逻辑
            // 处理完成后移除Token
            session.removeAttribute("token");
            return "success";
        } else {
            // Token验证失败，提示错误信息
            return "error";
        }
    }
}

form.html (Thymeleaf模板)：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Form</title>
</head>
<body>
<form th:action="@{/submit}" method="post">
    <input type="hidden" name="token" th:value="${token}"/>
    <label for="username">Username:</label>
    <input type="text" id="username" name="username" required/>
    <br/>
    <label for="password">Password:</label>
    <input type="password" id="password" name="password" required/>
    <br/>
    <button type="submit">Submit</button>
</form>
</body>
</html>

方法二：使用重定向

另一种简单有效的方法是在处理完表单后使用重定向，这样可以避免用户刷新页面导致的重复提交问题。

示例代码

Controller代码：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.servlet.mvc.support.RedirectAttributes;

@Controller
public class FormController {

    @GetMapping("/form")
    public String showForm() {
        return "form";
    }

    @PostMapping("/submit")
    public String submitForm(RedirectAttributes redirectAttributes) {
        // 处理表单逻辑
        // ...

        // 添加成功消息
        redirectAttributes.addFlashAttribute("message", "Form submitted successfully!");
        return "redirect:/result";
    }

    @GetMapping("/result")
    public String showResult() {
        return "result";
    }
}

form.html (Thymeleaf模板)：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Form</title>
</head>
<body>
<form th:action="@{/submit}" method="post">
    <label for="username">Username:</label>
    <input type="text" id="username" name="username" required/>
    <br/>
    <label for="password">Password:</label>
    <input type="password" id="password" name="password" required/>
    <br/>
    <button type="submit">Submit</button>
</form>
</body>
</html>

result.html (Thymeleaf模板)：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Result</title>
</head>
<body>
<h1 th:text="${message}"></h1>
<a href="/form">Back to form</a>
</body>
</html>

这两种方法都可以有效地防止表单重复提交，具体选择哪种方法可以根据实际需求和项目复杂度来决定。在Web开发中，防止用户重复提交表单是一个常见的需求，尤其是在处理诸如订单、支付等关键操作时。Spring MVC框架提供了几种有效的方法来防止表单的重复提交，包括使用Token机制、重定向策略以及JavaScript前端控制等。下面我将详细介绍这些方法及其代码实现。

1. 使用Token机制

原理：在用户访问页面时生成一个唯一的Token，并将其存储在服务器端（如Session）和客户端（如隐藏字段）。当用户提交表单时，服务端会验证这个Token的有效性。如果Token有效，则处理表单并删除或更新该Token；如果无效，则拒绝处理。

实现步骤：

  • 生成Token： 在Controller中生成Token，并将其添加到Model中以便在视图中使用。
@GetMapping("/form")
public String showForm(Model model, HttpSession session) {
    String token = UUID.randomUUID().toString();
    session.setAttribute("token", token);
    model.addAttribute("token", token);
    return "form";
}
  • 表单页面： 在表单中包含一个隐藏的Token字段。
<form action="/submit" method="post">
    <input type="hidden" name="token" value="${token}">
    <!-- 其他表单字段 -->
    <button type="submit">Submit</button>
</form>
  • 验证Token： 在处理表单提交的Controller方法中验证Token。
@PostMapping("/submit")
public String handleForm(@RequestParam String token, HttpSession session) {
    String sessionToken = (String) session.getAttribute("token");
    if (sessionToken != null && sessionToken.equals(token)) {
        // 处理表单逻辑
        session.removeAttribute("token"); // 防止重复提交
        return "success";
    } else {
        return "error"; // Token无效或已过期
    }
}

2. 使用重定向策略

原理：在处理完表单提交后，通过重定向到另一个页面来避免用户刷新页面导致的重复提交。

实现步骤：

  • 处理表单提交： 在处理完表单逻辑后，重定向到成功页面。
@PostMapping("/submit")
public String handleForm(/* 表单参数 */) {
    // 处理表单逻辑
    return "redirect:/success";
}
  • 成功页面： 显示成功信息的页面。
@GetMapping("/success")
public String success() {
    return "success";
}

3. 使用JavaScript前端控制

原理：在用户点击提交按钮时，通过JavaScript禁用提交按钮，防止用户多次点击。

实现步骤：

  • 表单页面： 添加JavaScript代码来禁用提交按钮。
<form id="myForm" action="/submit" method="post">
    <!-- 表单字段 -->
    <button type="submit" id="submitButton">Submit</button>
</form>

<script>
document.getElementById('myForm').addEventListener('submit', function() {
    document.getElementById('submitButton').disabled = true;
});
</script>

总结

以上三种方法都可以有效地防止表单的重复提交，具体选择哪种方法取决于你的应用场景和需求。Token机制是最常用且最安全的方法，重定向策略简单有效，而JavaScript前端控制则可以提供更好的用户体验。在实际开发中，通常会结合多种方法来确保系统的健壮性和安全性。

【声明】本内容来自华为云开发者社区博主，不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息，否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

目录

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入