萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

mysqli 事務控制陷阱:autocommit(false) 不夠、必須 begin_transaction() 且表必須為 InnoDB

PHP mysqli 事務「第一條成功、第二條失敗」卻未回滾,根因通常有三:未顯式啟動事務、變數拼寫錯誤、表引擎非 InnoDB。

錯誤代碼回顧

$con->autocommit(false);  // 僅關閉自動提交,未開啟事務!
foreach ($arr_sql as $sql) {
  if (!$con->query($sql)) {
    $resulf = false;  // 🐛 變數名拼寫錯誤:result → resulf
    $con->rollback();
    break;
  }
}
if ($result) $con->commit();  // $result 永遠 true
else $con->rollback();

正確模板 (PHP 5.5+ / mysqli 5.5+)

public static function exec_sql_tran(array $arr_sql): bool
{
    $mysqli = new MySQLi(DB_HOST, DB_USER, DB_PASS, DB_NAME);
    if ($mysqli->connect_errno) {
        error_log("Connect failed: " . $mysqli->connect_error);
        return false;
    }

    $mysqli->autocommit(false);
    $mysqli->begin_transaction();  // ✅ 關鍵:顯式開始事務 (PHP 5.5+)

    try {
        foreach ($arr_sql as $sql) {
            if (!$mysqli->query($sql)) {
                throw new Exception($mysqli->error);
            }
        }
        $mysqli->commit();
        return true;
    } catch (Exception $e) {
        $mysqli->rollback();
        error_log("Transaction rolled back: " . $e->getMessage());
        return false;
    } finally {
        $mysqli->close();
    }
}

PHP 5.5 以下版本替代寫法

$mysqli->autocommit(false);
$mysqli->query('START TRANSACTION');  // 或 BEGIN
// ... 同 try/catch ...
$mysqli->commit(); // 或 COMMIT

三大檢查清單

  1. 表引擎:SHOW TABLE STATUS WHERE Name='tbl'\G → Engine: InnoDB。MyISAM 不支援事務,任何寫入即時生效無法回滾。
  2. PHP 版本:begin_transaction() 需 PHP ≥ 5.5.0,舊版用 query('START TRANSACTION')。
  3. 變數拼寫:IDE 靜態分析或 declare(strict_types=1) 可提前攔截。

驗證步驟

-- 建立測試表 (InnoDB)
CREATE TABLE t_test (id INT PRIMARY KEY, val VARCHAR(20)) ENGINE=InnoDB;

-- PHP 執行:第一條正確、第二條故意語法錯誤
$arr = [
  "INSERT INTO t_test VALUES (1, 'ok')",
  "INSERT INTO t_test VALUES (2"  -- 缺右括號
];
var_dump(exec_sql_tran($arr));  // 應回傳 false
-- 檢查表資料:應為空表 (完整回滾)
SELECT * FROM t_test;

修正上述三點,mysqli 事務即能正確原子性執行。

copyright © 萬盛學電腦網 all rights reserved