萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 防止表單重複提交的完整解決方案

表單重複提交會導致數據重複、支付多扣款等嚴重問題。本文提供從簡單到企業級的多層次防重方案,覆蓋前端攔截、按鈕狀態管理、Token 機制、後端冪等性設計。

方案一:jQuery 數據標記法(原文改進版)


$(function() {
    $("form").on("submit", function(e) {
        var $form = $(this);

        // 檢查是否已提交
        if ($form.data("submitted")) {
            e.preventDefault();
            return false;
        }

        // 標記為已提交
        $form.data("submitted", true);

        // 禁用提交按鈕(防止用戶瘋狂點擊)
        $form.find("input[type=submit], input[type=button], button[type=submit]")
             .prop("disabled", true)
             .addClass("btn-loading");

        // 可選:顯示加載文本
        var $submitBtn = $form.find("button[type=submit], input[type=submit]").first();
        if ($submitBtn.length) {
            $submitBtn.data("original-text", $submitBtn.text() || $submitBtn.val());
            $submitBtn.text("提交中...").val("提交中...");
        }

        // 正常提交繼續(return true 不阻止默認行為)
        // 若為 AJAX 提交,這裡需 e.preventDefault() 並手動處理
    });
});

方案二:AJAX 表單專用防重(含恢復機制)


$.fn.ajaxSubmitOnce = function(options) {
    var defaults = {
        disabledClass: "btn-disabled",
        loadingText: "處理中...",
        restoreOnError: true, // 失敗時恢復按鈕
        timeout: 30000        // 超時自動恢復
    };
    var opts = $.extend({}, defaults, options);

    return this.each(function() {
        var $form = $(this);
        var $submitBtns = $form.find("button[type=submit], input[type=submit]");

        $form.on("submit", function(e) {
            e.preventDefault(); // 阻止默認提交,改用 AJAX

            if ($form.data("submitting")) return;

            $form.data("submitting", true);
            $submitBtns.prop("disabled", true).addClass(opts.disabledClass);

            var originalTexts = {};
            $submitBtns.each(function() {
                var $btn = $(this);
                originalTexts[this] = $btn.is("input") ? $btn.val() : $btn.text();
                $btn.is("input") ? $btn.val(opts.loadingText) : $btn.text(opts.loadingText);
            });

            // 超時保護
            var timer = setTimeout(function() {
                restoreButtons();
                showError("請求超時,請重試");
            }, opts.timeout);

            // 發起 AJAX
            $.ajax({
                url: $form.attr("action") || window.location.href,
                type: $form.attr("method") || "POST",
                data: $form.serialize(),
                dataType: "json"
            }).done(function(response) {
                clearTimeout(timer);
                if (response.success) {
                    opts.onSuccess ? opts.onSuccess(response) : defaultSuccess(response);
                } else {
                    handleError(response.message || "提交失敗");
                }
            }).fail(function(xhr) {
                clearTimeout(timer);
                handleError("網絡錯誤: " + xhr.status);
            });

            function handleError(msg) {
                showError(msg);
                if (opts.restoreOnError) restoreButtons();
            }

            function restoreButtons() {
                $form.data("submitting", false);
                $submitBtns.prop("disabled", false).removeClass(opts.disabledClass);
                $submitBtns.each(function() {
                    var txt = originalTexts[this];
                    this.tagName === "INPUT" ? $(this).val(txt) : $(this).text(txt);
                });
            }

            function defaultSuccess(res) {
                alert(res.message || "提交成功");
                // 可選:重定向、關閉彈窗、重置表單
            }

            function showError(msg) {
                // 接入項目統一提示組件
                alert(msg); // 示例用 alert
            }
        });
    });
};

// 使用
$("#myForm").ajaxSubmitOnce({
    onSuccess: function(res) {
        window.location.href = res.redirect || "/success";
    }
});

方案三:後端 Token 机制(根治方案)

前端攔截可被繞過,**後端冪等性是終極防線**。

Token 生成與驗證流程


// 1. 頁面渲染時生成 Token 存入 Session + 隱藏域
// Java Spring 示例
@GetMapping("/form")
public String form(Model model, HttpSession session) {
    String token = UUID.randomUUID().toString();
    session.setAttribute("form_token", token);
    model.addAttribute("formToken", token);
    return "form";
}

// 2. 表單包含 Token


// 3. 提交時驗證並消費 Token
@PostMapping("/submit")
public Result submit(@RequestParam String formToken, HttpSession session) {
    String serverToken = (String) session.getAttribute("form_token");

    if (serverToken == null || !serverToken.equals(formToken)) {
        return Result.error("重複提交或表單已過期");
    }

    // 驗證通過:移除 Token(消費掉),處理業務
    session.removeAttribute("form_token");
    doBusiness();
    return Result.success();
}

方案四:分布式環境下的 Redis 防重


// Spring Boot + Redis
@Autowired StringRedisTemplate redisTemplate;

@PostMapping("/submit")
public Result submit(@RequestParam String formToken) {
    String key = "form_submit:" + formToken;

    // setIfAbsent 原子操作:只有不存在時設置成功
    Boolean success = redisTemplate.opsForValue().setIfAbsent(key, "1", 10, TimeUnit.MINUTES);

    if (!success) {
        return Result.error("請勿重複提交");
    }

    try {
        doBusiness();
        return Result.success();
    } finally {
        // 業務完成後可選刪除或保留防重
        // redisTemplate.delete(key);
    }
}

綜合防禦體系

層級方案防禦能力用戶體驗
1. 前端 UI按鈕禁用 + Loading 狀態防誤操作良好
2. 前端 邏輯data 標記 / 變量鎖防普通用戶重複點擊良好
3. 後端 Session Token單機冪等 Token防繞過前端/瀏覽器重試需處理 Token 過期
4. 後端 Redis Token分布式冪等 Token防集群/重放攻擊最強
5. 數據庫 唯一約束業務主鍵/唯一索引終極數據完整性需處理異常轉換

最佳實踐清單

  1. ✅ 前端:按鈕即時禁用 + Loading 文本 + data 標記
  2. ✅ AJAX 表單:`e.preventDefault()` + 統一防重封裝
  3. ✅ 後端:業務級 Token 冪等(Session 或 Redis)
  4. ✅ 數據庫:關鍵業務表加唯一約束(訂單號、流水號)
  5. ✅ 異常處理:捕獲唯一約束異常轉為友好提示「已提交,請勿重複操作」
  6. ✅ 超時恢復:前端設置超時自動恢復按鈕,防止死鎖

多層防禦、冪等設計、用戶體驗三位一體,構建零重複提交的可靠系統。

copyright © 萬盛學電腦網 all rights reserved