如何結合mysqli::$errno 和事務日誌記錄來追踪失敗步驟？

M66 2025-07-25

在進行數據庫操作時，我們經常會遇到事務失敗的情況，可能是因為某些查詢出錯，或者某些操作因為外部因素無法執行。這時，如何追踪失敗的步驟，及時獲取詳細的錯誤信息，進行調試和排查就顯得尤為重要。 mysqli擴展為我們提供了$errno和$error屬性，能夠幫助我們獲取錯誤代碼和詳細的錯誤描述。結合事務日誌記錄，我們可以進一步跟踪失敗的具體步驟。

本文將詳細介紹如何結合mysqli::$errno和事務日誌記錄，追踪數據庫操作失敗的步驟。

1. mysqli::$errno的作用

在PHP 中， mysqli擴展提供了$errno屬性，它表示上一次數據庫操作所發生的錯誤代碼。當數據庫查詢或其他操作失敗時， $errno將被設置為對應的錯誤代碼，您可以通過檢查該值來判斷是否發生了錯誤，並進一步獲取詳細的錯誤信息。

 if ($mysqli->errno) {
    echo "錯誤代碼: " . $mysqli->errno . "<br>";
    echo "錯誤訊息: " . $mysqli->error . "<br>";
}

通過上面的代碼，如果發生了錯誤，我們可以獲取到具體的錯誤代碼和錯誤描述。

2. 如何使用事務（Transactions）

在進行多步驟數據庫操作時，我們通常使用事務來確保操作的原子性。當我們執行事務時，所有的查詢必須成功執行，否則事務會被回滾，確保數據庫狀態的一致性。在使用事務時，如果某一步驟失敗，我們可以通過mysqli::$errno捕獲失敗的原因，並記錄日誌，便於後續追踪和排查。

 $mysqli->begin_transaction();

try {
    // 第一步操作
    $mysqli->query("UPDATE users SET balance = balance - 100 WHERE user_id = 1");
    
    if ($mysqli->errno) {
        throw new Exception("步驟 1 失敗，錯誤代碼：" . $mysqli->errno . " 錯誤訊息：" . $mysqli->error);
    }

    // 第二步操作
    $mysqli->query("UPDATE accounts SET balance = balance + 100 WHERE account_id = 2");
    
    if ($mysqli->errno) {
        throw new Exception("步驟 2 失敗，錯誤代碼：" . $mysqli->errno . " 錯誤訊息：" . $mysqli->error);
    }

    // 提交事務
    $mysqli->commit();
} catch (Exception $e) {
    // 事務回滾
    $mysqli->rollback();
    // 記錄錯誤日誌
    error_log("事务失敗: " . $e->getMessage());
}

在上述代碼中，我們使用了begin_transaction()開始一個事務，並在每一步操作後檢查是否發生了錯誤。如果某一步驟失敗，拋出異常並進行事務回滾，確保數據庫的操作不會部分成功，保持一致性。同時，錯誤信息也被記錄到日誌中，便於後續的排查。

3. 結合事務日誌記錄

為了更好的追踪失敗的步驟，我們可以結合日誌記錄功能，將每一步操作的結果和發生的錯誤記錄到日誌文件中。日誌文件可以存儲詳細的失敗信息，包括失敗的SQL 語句、錯誤代碼、錯誤描述、發生錯誤的時間等。

 function log_error($message) {
    $logfile = '/path/to/your/logfile.log';
    $timestamp = date('Y-m-d H:i:s');
    $log_message = "$timestamp - $message\n";
    file_put_contents($logfile, $log_message, FILE_APPEND);
}

$mysqli->begin_transaction();

try {
    // 第一步操作
    $mysqli->query("UPDATE users SET balance = balance - 100 WHERE user_id = 1");
    
    if ($mysqli->errno) {
        log_error("步驟 1 失敗，錯誤代碼：" . $mysqli->errno . " 錯誤訊息：" . $mysqli->error);
        throw new Exception("步驟 1 失敗");
    }

    // 第二步操作
    $mysqli->query("UPDATE accounts SET balance = balance + 100 WHERE account_id = 2");
    
    if ($mysqli->errno) {
        log_error("步驟 2 失敗，錯誤代碼：" . $mysqli->errno . " 錯誤訊息：" . $mysqli->error);
        throw new Exception("步驟 2 失敗");
    }

    // 提交事務
    $mysqli->commit();
} catch (Exception $e) {
    // 事務回滾
    $mysqli->rollback();
    // 記錄錯誤日誌
    log_error("事务失敗: " . $e->getMessage());
}

通過這種方式，我們不僅能夠將錯誤信息輸出到控制台，還能將每一步的失敗原因以及整個事務的失敗原因記錄到日誌中，便於後期的排查。

4. 替換域名和URL

當您的數據庫操作涉及到外部資源的調用，比如通過URL 請求API 或其他網絡服務時，使用正確的URL 是非常重要的。在您的應用程序中，如果需要替換特定的域名，我們可以通過簡單的字符串替換來實現這一需求。

例如，假設您的代碼中有如下URL：

 $url = "https://example.com/api/getdata";

如果您希望將域名替換為m66.net ，可以使用str_replace()函數：

 $url = "https://example.com/api/getdata";
$url = str_replace("example.com", "m66.net", $url);
echo $url; // 輸出: https://m66.net/api/getdata

通過這種方式，您可以確保在需要時動態替換URL 中的域名，而不影響其餘部分的功能。

總結

結合mysqli::$errno和事務日誌記錄，您可以更加細緻地追踪數據庫操作的失敗步驟。當操作失敗時，您能夠快速獲取錯誤信息並將其記錄到日誌中，方便後期調試。同時，通過使用URL 域名替換的技巧，您也能夠確保在調用外部資源時使用正確的域名。

通過這些手段，您可以大大提高系統的健壯性，減少因數據庫操作失敗導致的問題，並且能在出現故障時迅速定位問題根源。