表單重複提交會導致數據重複、支付多扣款等嚴重問題。本文提供從簡單到企業級的多層次防重方案,覆蓋前端攔截、按鈕狀態管理、Token 機制、後端冪等性設計。
$(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() 並手動處理
});
});
$.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";
}
});
前端攔截可被繞過,**後端冪等性是終極防線**。
// 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();
}
// 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. 數據庫 唯一約束 | 業務主鍵/唯一索引 | 終極數據完整性 | 需處理異常轉換 |
多層防禦、冪等設計、用戶體驗三位一體,構建零重複提交的可靠系統。