如何使用mysqli::$errno 捕獲和處理SQL 執行錯誤，確保數據庫操作的健壯性？

M66 2025-07-28

在進行數據庫操作時，錯誤處理是一個至關重要的環節，尤其是在復雜的項目中。當你使用PHP 的MySQLi 擴展進行數據庫操作時，捕獲並處理SQL 執行錯誤能夠確保程序的穩定性與健壯性。本文將介紹如何使用mysqli::$errno屬性來捕獲並處理SQL 錯誤。

1. 什麼是mysqli::$errno ？

mysqli::$errno是PHP MySQLi 擴展中的一個屬性，用於獲取最近一次MySQL 操作的錯誤代碼。這個錯誤代碼是一個整數值，代表了數據庫操作失敗的具體原因。通過這個屬性，你可以了解發生錯誤的原因，從而決定如何處理這個錯誤。

當執行SQL 語句時，可能會遇到各種類型的錯誤，例如語法錯誤、連接問題、權限問題等。 mysqli::$errno可以幫助你獲取這些錯誤的具體代碼，進而對錯誤進行針對性的處理。

2. 示例代碼：如何捕獲和處理SQL 錯誤？

以下是一個簡單的PHP 示例，演示如何使用mysqli::$errno來捕獲和處理SQL 錯誤。

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

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

// 執行 SQL 查詢
$sql = "SELECT * FROM non_existent_table"; // 故意寫錯表名
$result = $mysqli->query($sql);

// 檢查是否發生錯誤
if ($mysqli->errno) {
    echo "SQL 錯誤代碼: " . $mysqli->errno . "<br>";
    echo "錯誤訊息: " . $mysqli->error . "<br>";
    // 根据錯誤代碼处理错误
    if ($mysqli->errno == 1146) {
        echo "表不存在，請檢查表名！<br>";
    } else {
        echo "發生了其他錯誤，請聯繫管理員！<br>";
    }
} else {
    // 正常處理結果
    while ($row = $result->fetch_assoc()) {
        echo "ID: " . $row['id'] . " - Name: " . $row['name'] . "<br>";
    }
}

// 关闭數據庫連接
$mysqli->close();
?>

3. 代碼解析

數據庫連接：首先，我們通過new mysqli()創建一個到數據庫的連接，並檢查連接是否成功。如果連接失敗，將會使用die()函數輸出錯誤信息並終止腳本。
SQL 查詢執行：接著，我們執行一個故意寫錯的SQL 查詢，這裡使用的是一個不存在的表名。
錯誤檢查：執行查詢後，我們使用$mysqli->errno檢查是否發生了SQL 錯誤。如果發生了錯誤， $mysqli->errno將返回一個非零的錯誤代碼。通過mysqli::$errno ，我們可以獲取具體的錯誤代碼，並根據這個代碼採取適當的措施。
錯誤處理：根據錯誤代碼，我們可以進行自定義的錯誤處理，例如，如果錯誤代碼是1146 （表示表不存在），我們就給出相應的提示。

4. 常見的MySQL 錯誤代碼

以下是一些常見的MySQL 錯誤代碼：

1045 : 權限錯誤（Access Denied），表示用戶名或密碼錯誤。
1146 : 表不存在（Table doesn't exist）。
1064 : SQL 語法錯誤（Syntax error in SQL）。
2002 : 無法連接到MySQL 服務器（Can't connect to MySQL server）。

根據具體的錯誤代碼，你可以有針對性地進行錯誤處理，比如記錄錯誤日誌、通知管理員，或者顯示用戶友好的錯誤信息。

5. 錯誤處理的重要性

在實際開發中，處理數據庫錯誤是確保系統穩定性的關鍵。如果不處理數據庫錯誤，程序可能會在運行時崩潰，導致數據丟失或者係統不可用。通過捕獲SQL 錯誤並進行適當的處理，可以有效避免這些問題。例如，你可以在錯誤發生時記錄詳細的錯誤信息，或者在用戶端顯示簡潔友好的錯誤提示。

6. 總結

通過使用mysqli::$errno來捕獲和處理SQL 錯誤，我們可以確保數據庫操作的健壯性，減少因錯誤引起的崩潰或數據問題。在開發過程中，良好的錯誤處理不僅能幫助開發者更快定位問題，還能提升用戶體驗，使系統更加穩定和安全。

以上就是關於如何使用mysqli::$errno捕獲和處理SQL 錯誤的詳細介紹。希望這篇文章能幫助你更好地理解如何處理數據庫操作中的錯誤，提高程序的健壯性。如果你有任何問題，歡迎隨時提問！

相關標籤:
mysqli SQL