如何通過mysqli::$errno 快速定位mysqli_stmt_execute() 出錯的原因？

M66 2025-06-23

在使用PHP 的mysqli擴展進行數據庫操作時，執行數據庫查詢時出現錯誤是不可避免的。尤其是在使用mysqli_stmt_execute()執行預處理語句時，有時錯誤信息並不直接說明出錯的具體原因，這時我們就需要藉助mysqli::$errno屬性來幫助我們定位錯誤。

1. 什麼是mysqli::$errno ？

mysqli::$errno是PHP 中mysqli擴展的一個屬性，表示上一次MySQL 操作發生的錯誤代碼。當執行mysqli_stmt_execute()出現錯誤時，可以通過mysqli::$errno獲取詳細的錯誤代碼，從而幫助開發人員快速定位問題。

mysqli::$errno與mysqli::$error配合使用，能夠幫助我們更好地理解MySQL 數據庫操作中的異常。

2. mysqli_stmt_execute()出錯的常見原因

在使用mysqli_stmt_execute()執行預處理語句時，常見的出錯原因可能包括：

SQL 語句中的語法錯誤。
參數綁定錯誤，例如綁定了不匹配的數據類型。
數據庫連接的問題。
數據庫訪問權限不足等。

這些錯誤有時會通過返回的布爾值或mysqli::$error給出提示，但要精確定位問題，我們可以結合mysqli::$errno來獲取錯誤的錯誤代碼。

3. 如何使用mysqli::$errno定位錯誤？

我們可以通過mysqli_stmt_execute()返回的布爾值來判斷是否執行成功。如果返回false ，則表示執行失敗。此時，我們可以通過mysqli::$errno和mysqli::$error來獲取詳細的錯誤信息。

示例代碼：

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

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

// 準備 SQL 語句
$stmt = $mysqli->prepare("INSERT INTO users (username, email) VALUES (?, ?)");

// 綁定參數
$username = 'testuser';
$email = 'testuser@m66.net';
$stmt->bind_param("ss", $username, $email);

// 执行語句
if (!$stmt->execute()) {
    echo "錯誤代碼: " . $stmt->errno . "<br>";
    echo "錯誤訊息: " . $stmt->error . "<br>";
} else {
    echo "插入成功！<br>";
}

// 关闭語句和连接
$stmt->close();
$mysqli->close();
?>

代碼分析：

數據庫連接：首先，我們通過new mysqli()創建數據庫連接，並檢查連接是否成功。
準備SQL 語句：我們使用prepare()方法準備一個SQL 插入語句，準備插入用戶數據。
綁定參數：通過bind_param()方法綁定插入的參數，確保數據類型正確。
執行語句並檢查錯誤：執行mysqli_stmt_execute()方法時，如果返回false ，說明執行出錯。我們可以通過$stmt->errno獲取錯誤代碼，通過$stmt->error獲取錯誤描述。
在上面的代碼中，如果執行出錯，我們會輸出錯誤代碼和錯誤信息，幫助我們快速定位問題。
關閉連接：最後，我們關閉預處理語句和數據庫連接。

4. 錯誤碼常見解釋

通過mysqli::$errno獲取的錯誤碼是MySQL 數據庫返回的標準錯誤代碼。以下是一些常見的錯誤代碼：

1045 ： Access denied for user - 數據庫訪問權限不足。
1064 ： You have an error in your SQL syntax - SQL 語法錯誤。
1062 ： Duplicate entry - 插入重複數據，違反唯一約束。
2002 ： Can't connect to local MySQL server - 無法連接到MySQL 服務器。

這些錯誤碼幫助我們明確數據庫操作失敗的原因。

5. 總結

通過mysqli::$errno屬性，我們可以快速獲得數據庫操作中的錯誤代碼，結合mysqli::$error的錯誤信息，能夠更容易地定位問題的根源。當mysqli_stmt_execute()出現錯誤時，確保首先檢查返回值並通過錯誤碼進一步排查問題，從而提高開發效率並減少調試時間。