表單重複提交會導致重複訂單、積分重複發放、數據髒讀等嚴重業務問題。單靠前端攔截不可靠(用戶可禁用 JS、繞過驗證),必須在服務端實現**冪等性**保障。本文系統梳理前端攔截、Token 令牌、數據庫唯一約束、分布式鎖四層防護體系,提供生產級代碼實現。
| 場景 | 成因 | 後果 |
|---|---|---|
| 用戶連點提交按鈕 | 網絡延遲、無加載狀態反饋 | 重複下單、扣款 |
| 頁面刷新 (F5) | 瀏覽器重發 POST 請求 | 重複寫入 |
| 瀏覽器前進/後退 | 歷史記錄重新提交 | 重複處理 |
| 惡意腳本/爬蟲 | 高頻自動化提交 | 資源耗盡、數據汙染 |
| 網關/代理重試 | 超時重試機制 | 非冪等接口重複執行 |
<form id="orderForm" method="post" action="/order/create">
<button type="submit" id="submitBtn">提交訂單</button>
</form>
<script>
document.getElementById('orderForm').addEventListener('submit', function(e) {
const btn = document.getElementById('submitBtn');
if (btn.dataset.submitting === '1') {
e.preventDefault();
alert('正在處理,請勿重複提交');
return;
}
btn.dataset.submitting = '1';
btn.disabled = true;
btn.textContent = '提交中...';
// 表單正常提交
});
</script>
<script>
let submitCount = 0;
document.getElementById('orderForm').addEventListener('submit', function(e) {
if (submitCount++ > 0) {
e.preventDefault();
alert('已提交,請勿重複操作');
}
});
</script>
原理:表單渲染時生成唯一 Token 存入 Session,提交時驗證並銷毀。同一 Token 只能使用一次。
<?php
// form.php - 表單頁
session_start();
// 生成隨機 Token
$token = bin2hex(random_bytes(32));
$_SESSION['form_tokens'][$token] = [
'created' => time(),
'action' => 'create_order',
'used' => false,
];
?>
<form method="post" action="submit.php">
<input type="hidden" name="csrf_token" value="<?= htmlspecialchars($token) ?>">
<!-- 其他字段 -->
<button type="submit">提交</button>
</form>
<?php
// submit.php - 處理頁
session_start();
$token = $_POST['csrf_token'] ?? '';
$tokenData = $_SESSION['form_tokens'][$token] ?? null;
// 驗證
if (!$tokenData) {
die('無效請求:Token 不存在或已過期');
}
if ($tokenData['used']) {
die('重複提交:該表單已處理過');
}
if ($tokenData['action'] !== 'create_order') {
die('非法操作:Token 用途不匹配');
}
if (time() - $tokenData['created'] > 3600) { // 1 小時過期
die('表單已過期,請刷新頁面重試');
}
// 標記已使用
$_SESSION['form_tokens'][$token]['used'] = true;
// 核心業務邏輯(需配合數據庫唯一約束/分布式鎖)
try {
createOrder($_POST);
echo '訂單創建成功';
} catch (Exception $e) {
// 業務失敗時,可選:保留 Token 允許重試,或記錄日誌人工介入
error_log("Order create failed: " . $e->getMessage());
echo '系統繁忙,請稍後再試';
}
?>
<?php
class FormTokenManager {
private const TOKEN_TTL = 7200; // 2小時
private const MAX_TOKENS_PER_ACTION = 10; // 防止 Session 膨脹
public static function generate(string $action, array $metadata = []): string {
session_start();
$tokens = &$_SESSION['form_tokens'][$action] ?? [];
// 清理過期/已用 Token
$tokens = array_filter($tokens, function($t) {
return !$t['used'] && (time() - $t['created'] < self::TOKEN_TTL);
});
// 限制數量
if (count($tokens) >= self::MAX_TOKENS_PER_ACTION) {
array_shift($tokens); // 移除最舊
}
$token = bin2hex(random_bytes(32));
$tokens[$token] = [
'created' => time(),
'used' => false,
'metadata' => $metadata, // 可存儲表單快照、步驟標識等
];
$_SESSION['form_tokens'][$action] = $tokens;
return $token;
}
public static function validate(string $action, string $token): array|false {
session_start();
$tokenData = $_SESSION['form_tokens'][$action][$token] ?? null;
if (!$tokenData) return false;
if ($tokenData['used']) return false;
if (time() - $tokenData['created'] > self::TOKEN_TTL) return false;
// 標記使用
$_SESSION['form_tokens'][$action][$token]['used'] = true;
return $tokenData;
}
public static function invalidate(string $action, string $token): void {
session_start();
unset($_SESSION['form_tokens'][$action][$token]);
}
}
// 使用示例
// 表單頁
$token = FormTokenManager::generate('create_order', ['user_id' => $userId]);
// 處理頁 (AJAX 返回 JSON)
header('Content-Type: application/json');
$token = $_POST['csrf_token'] ?? '';
$data = FormTokenManager::validate('create_order', $token);
if (!$data) {
echo json_encode(['code' => 400, 'msg' => 'Token 無效或重複提交']);
exit;
}
// 繼續業務...
?>
業務邏輯層面的去重:為關鍵業務表添加**唯一索引**,利用資料庫 ACID 特性保證絕對不重複。
CREATE TABLE `orders` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
`order_no` VARCHAR(32) NOT NULL COMMENT '業務唯一單號',
`user_id` BIGINT UNSIGNED NOT NULL,
`idempotency_key` VARCHAR(64) NOT NULL COMMENT '冪等鍵:客戶端生成 UUID',
`amount` DECIMAL(10,2) NOT NULL,
`status` TINYINT NOT NULL DEFAULT 0,
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `uk_idempotency_key` (`idempotency_key`), -- 核心:防重複
UNIQUE KEY `uk_order_no` (`order_no`),
INDEX `idx_user_status` (`user_id`, `status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
<?php
function createOrder(array $data): string {
$pdo = getPdo(); // 你的 PDO 實例
$idempotencyKey = $data['idempotency_key'] ?? bin2hex(random_bytes(16));
$orderNo = generateOrderNo(); // 你的單號生成邏輯
$sql = "INSERT INTO `orders` (`order_no`, `user_id`, `idempotency_key`, `amount`, `status`)
VALUES (:order_no, :user_id, :idempotency_key, :amount, 0)";
try {
$stmt = $pdo->prepare($sql);
$stmt->execute([
':order_no' => $orderNo,
':user_id' => $data['user_id'],
':idempotency_key' => $idempotencyKey,
':amount' => $data['amount'],
]);
return $pdo->lastInsertId();
} catch (PDOException $e) {
if ($e->getCode() === '23000') { // SQLSTATE 23000: Integrity constraint violation
// 唯一鍵衝突,說明已存在相同冪等鍵的訂單
$existing = $pdo->query("SELECT id FROM orders WHERE idempotency_key = " . $pdo->quote($idempotencyKey))->fetchColumn();
if ($existing) {
throw new Exception("訂單已存在 (ID: $existing)", 409);
}
}
throw $e;
}
}
?>
單機 Token + DB 唯一鍵足以應對 99% 場景。極高併發(秒殺、搶購)或分布式部署時,需引入 Redis 分布式鎖:
<?php
function acquireLock(string $key, int $ttl = 10): bool {
$redis = getRedis();
// SET NX EX 原子操作
return $redis->set("lock:$key", "1", ['nx', 'ex' => $ttl]);
}
function releaseLock(string $key): void {
$redis = getRedis();
// Lua 腳本保證只刪除自己的鎖
$lua = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end";
$redis->eval($lua, 1, "lock:$key", "1");
}
// 業務代碼
$lockKey = "order_create:{$userId}:{$idempotencyKey}";
if (!acquireLock($lockKey)) {
throw new Exception('系統繁忙,請稍後再試 (LOCK_BUSY)');
}
try {
// 此處再次檢查 DB 唯一鍵(雙重檢查)
return createOrder($data);
} finally {
releaseLock($lockKey);
}
?>
csrf_token(防 CSRF)+ idempotency_key(業務冪等)。idempotency_key、order_no)。proxy_next_upstream error timeout http_500 http_502 http_503 http_504; proxy_next_upstream_tries 1; 禁止對非冪等請求重試。