如何通過mysqli::$errno 輔助調試mysqli_autocommit() 提交問題，定位錯誤原因

M66 2025-07-04

在PHP 中， mysqli_autocommit()函數用於開啟或關閉自動提交事務的功能。默認情況下，MySQL 在每條查詢執行後自動提交事務。但在某些情況下，開發者可能需要關閉自動提交功能，以便在執行多個查詢時保持事務一致性。在這種情況下，開發者需要手動調用commit()或rollback()來提交或回滾事務。

然而，有時我們會遇到提交事務時的問題，尤其是在使用mysqli_autocommit()時。為了定位這些問題， mysqli::$errno和mysqli::$error這兩個屬性就顯得尤為重要。 mysqli::$errno可以幫助我們獲取MySQL 操作的錯誤代碼，而mysqli::$error則提供了錯誤信息。結合這兩個屬性，開發者可以方便地調試和定位問題。

使用mysqli::$errno調試mysqli_autocommit()提交問題

首先，我們來看一個基本的PHP 示例，演示如何使用mysqli_autocommit()進行事務控制，以及如何使用mysqli::$errno來調試提交事務時出現的錯誤。

示例代碼

<?php
// 創建數據庫連接
$mysqli = new mysqli("localhost", "username", "password", "database");

// 檢查連接是否成功
if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

// 關閉自動提交事務
$mysqli->autocommit(false);

// 開始事務
$mysqli->begin_transaction();

try {
    // 執行第一個查詢
    $mysqli->query("INSERT INTO users (username, email) VALUES ('user1', 'user1@m66.net')");
    
    // 執行第二個查詢
    $mysqli->query("INSERT INTO orders (user_id, product) VALUES (1, 'product1')");

    // 檢查是否有錯誤發生
    if ($mysqli->errno) {
        // 如果有錯誤，回滾事務
        throw new Exception("錯誤：".$mysqli->error);
    }

    // 提交事務
    $mysqli->commit();

    echo "事務成功提交！";
} catch (Exception $e) {
    // 如果捕獲到異常，回滾事務
    $mysqli->rollback();
    echo "事務回滾，錯誤信息：" . $e->getMessage();
}

// 關閉數據庫連接
$mysqli->close();
?>

代碼分析

連接數據庫：我們首先通過new mysqli()創建了數據庫連接，連接到MySQL 服務器。如果連接失敗，則通過$mysqli->connect_error獲取錯誤信息並終止程序。
關閉自動提交：使用$mysqli->autocommit(false)來關閉自動提交模式。這意味著每次查詢後都不會立即提交，而是需要手動調用commit()來提交事務。
執行事務：我們通過$mysqli->begin_transaction()開始事務，並通過$mysqli->query()執行插入操作。如果有任何查詢出錯， $mysqli->errno將會返回錯誤代碼， $mysqli->error返回錯誤描述。
錯誤處理：如果在執行查詢時發生錯誤，我們通過if ($mysqli->errno)判斷並捕獲錯誤。如果錯誤發生，我們使用throw new Exception()拋出異常，並回滾事務（ $mysqli->rollback() ）。
提交事務：如果所有查詢都沒有錯誤，我們調用$mysqli->commit()提交事務。
關閉連接：最後，使用$mysqli->close()關閉數據庫連接。

如何使用mysqli::$errno定位錯誤原因

在上面的代碼中， $mysqli->errno主要用於判斷查詢是否成功執行。如果查詢失敗， $mysqli->errno會返回一個非零的錯誤代碼，而$mysqli->error會返回具體的錯誤描述信息。通過這些信息，我們可以快速定位問題所在。

如果$mysqli->errno為0 ，表示沒有錯誤發生。
如果$mysqli->errno為非零值，表示出現了錯誤，我們可以通過$mysqli->error來查看具體的錯誤信息。

例如，如果在執行INSERT查詢時，表中已有重複數據導致插入失敗，MySQL 會返回錯誤碼1062 （表示重複鍵錯誤）。此時， $mysqli->errno會返回1062 ，而$mysqli->error會返回類似"Duplicate entry 'user1' for key 'PRIMARY'" 的錯誤信息。

常見的MySQL 錯誤代碼

1062 - 重複條目錯誤（例如主鍵重複）
1046 - 沒有選擇數據庫
1146 - 表不存在
2002 - 連接到MySQL 服務器失敗

通過$mysqli->errno和$mysqli->error ，我們可以有效地定位錯誤原因並及時採取相應的措施。

總結

在使用mysqli_autocommit()進行事務控制時，遇到提交問題時， mysqli::$errno和mysqli::$error是非常有用的調試工具。它們可以幫助開發者快速定位錯誤原因，從而更高效地調試和解決問題。在實際開發過程中，記得合理地使用事務和錯誤處理機制，以確保數據庫操作的可靠性和穩定性。