Token 機制防止表單重複提交：原理與實戰代碼

Token 機制防止表單重複提交：原理與實戰代碼

表單重複提交常見於三種情境：伺服器響應緩慢導致使用者多次點擊；提交成功後刷新頁面；提交成功後返回表單頁再次點擊。Token 模式能有效解決此問題。

核心邏輯

1. 伺服器生成唯一 Token（如 UUID），存入 Session，並將 Token 隱藏於表單中。
2. 使用者提交表單時攜帶 Token。
3. 伺服器比對 Session 中的 Token 與表單提交的 Token，一致則處理業務並移除 Session Token；不一致或 Token 缺失則拒絕處理。

完整實現代碼

後端 Servlet

package com.jalja.token;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.UUID;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class UserServlet extends HttpServlet {
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doPost(request, response);
    }
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        request.setCharacterEncoding("utf-8");
        response.setContentType("text/html;charset=utf-8");
        String contextPath = request.getContextPath();
        String requestURI = request.getRequestURI();
        String path = requestURI.substring(contextPath.length() + 1, requestURI.length());
        String token = "";
        if ("index.do".equals(path)) {
            token = UUID.randomUUID().toString();
            System.out.println("生成的 token：" + token);
            request.getSession().setAttribute("token", token);
            request.getRequestDispatcher("/index.jsp").forward(request, response);
        }
        if ("token.do".equals(path)) {
            String name = request.getParameter("username");
            String tokenValue = request.getParameter("tokenValue");
            System.out.println("客戶端 token：" + tokenValue);
            String serverToken = (String) request.getSession().getAttribute("token");
            if (tokenValue != null && serverToken != null && serverToken.equals(tokenValue)) {
                System.out.println("處理請求，name：" + name);
                try { Thread.sleep(3000); } catch (InterruptedException e) { e.printStackTrace(); }
            } else {
                System.out.println("不處理：Token 驗證失敗");
            }
            request.getSession().removeAttribute("token");
        }
    }
}

前端 JSP

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head><title>防止表單重複提交</title></head>
<body>
<h2>防止表單重複提交</h2>
<form action="${pageContext.request.contextPath}/token.do" method="post">
    <input type="hidden" value="${token}" name="tokenValue"/>
    用戶名：<input type="text" name="username"/>
    <input type="submit" value="提交" id="submit"/>
</form>
</body>
</html>

web.xml 配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="https://java.sun.com/xml/ns/javaee"
    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://java.sun.com/xml/ns/javaee https://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <servlet>
        <servlet-name>token</servlet-name>
        <servlet-class>com.jalja.token.UserServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>token</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
</web-app>

關鍵點總結

• Token 必須具備唯一性與不可預測性（使用 UUID）。
• Token 存放於 Session，表單透過隱藏域攜帶。
• 驗證通過後立即從 Session 移除 Token，確保一次性使用。
• 適用於防止重複提交、CSRF 防護等場景。