萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 防止表單重複提交:客戶端與服務端雙重防護

表單重複提交會導致重複訂單、積分重複發放、數據髒讀等嚴重業務問題。單靠前端攔截不可靠(用戶可禁用 JS、繞過驗證),必須在服務端實現**冪等性**保障。本文系統梳理前端攔截、Token 令牌、數據庫唯一約束、分布式鎖四層防護體系,提供生產級代碼實現。

威脅模型分析

場景成因後果
用戶連點提交按鈕網絡延遲、無加載狀態反饋重複下單、扣款
頁面刷新 (F5)瀏覽器重發 POST 請求重複寫入
瀏覽器前進/後退歷史記錄重新提交重複處理
惡意腳本/爬蟲高頻自動化提交資源耗盡、數據汙染
網關/代理重試超時重試機制非冪等接口重複執行

第一層:客戶端攔截(體驗優化,非安全防線)

1.1 按鈕置灰 + 狀態鎖

<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>

1.2 提交計數器(防止多標籤頁)

<script>
let submitCount = 0;
document.getElementById('orderForm').addEventListener('submit', function(e) {
    if (submitCount++ > 0) {
        e.preventDefault();
        alert('已提交,請勿重複操作');
    }
});
</script>

第二層:服務端 Token 令牌(核心防線)

原理:表單渲染時生成唯一 Token 存入 Session,提交時驗證並銷毀。同一 Token 只能使用一次。

2.1 基礎實現

<?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 '系統繁忙,請稍後再試';
}
?>

2.2 進階:支持多標籤頁、AJAX、多步驟表單

<?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 寫入邏輯

<?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);
}
?>

綜合防護清單

  1. ✅ 前端:按鈕置灰、提交計數、禁用 Enter 鍵提交。
  2. ✅ 表單:每個 POST 表單包含 csrf_token(防 CSRF)+ idempotency_key(業務冪等)。
  3. ✅ 服務端:Token 驗證+銷毀、Session 存儲 Token 狀態。
  4. ✅ 數據庫:關鍵表**必須**有業務唯一鍵(idempotency_key、order_no)。
  5. ✅ 高併發:Redis 分布式鎖保護寫入臨界區。
  6. ✅ 幂等性設計:所有寫入接口設計為**冪等**(同參數多次調用結果一致)。
  7. ✅ 監控告警:監控「重複提交拒絕次數」、「唯一鍵衝突次數」,異常激增即報警。

常見誤區

  • ❌ 只靠前端攔截:繞過極簡單,必須有服務端校驗。
  • ❌ 用 Session 防重但不銷毀 Token:導致用戶無法正常重試(如網絡波動導致首次失敗)。
  • ❌ 業務冪等鍵用隨機數:必須由**客戶端生成並傳遞**(如 UUID),服務端不可自行生成,否則重試時鍵不一致。
  • ❌ 忽略網關重試:Nginx/網關層配置 proxy_next_upstream error timeout http_500 http_502 http_503 http_504; proxy_next_upstream_tries 1; 禁止對非冪等請求重試。
copyright © 萬盛學電腦網 all rights reserved