使用mysqli_stmt::$error 調試預處理語句中的問題

gitbox 2025-05-28

在使用PHP 操作MySQL 數據庫時，預處理語句（prepared statements）能有效防止SQL 注入，提升安全性和代碼可維護性。然而，在編寫和執行預處理語句的過程中，可能會出現各種錯誤，如語法錯誤、參數綁定錯誤或執行失敗等。

為了快速定位這些問題， mysqli_stmt::$error是一個非常有用的調試工具。它是mysqli_stmt類中的一個屬性，可以在執行語句失敗時，返回具體的錯誤信息，幫助開發者迅速找到問題所在。

基本用法

以下是一個使用mysqli_stmt::$error的基本示例：

 <?php
$mysqli = new mysqli("localhost", "db_user", "db_pass", "test_db");

if ($mysqli->connect_errno) {
    die("連接失敗: " . $mysqli->connect_error);
}

$sql = "INSERT INTO users (username, email) VALUES (?, ?)";
$stmt = $mysqli->prepare($sql);

if (!$stmt) {
    die("預處理失敗: " . $mysqli->error);
}

// 故意將參數綁定寫錯：假設應該綁定兩個參數，這裡只綁定一個
$stmt->bind_param("s", $username);

$username = "alice";
$email = "[email protected]";

if (!$stmt->execute()) {
    // 使用 mysqli_stmt::$error 輸出詳細錯誤
    echo "執行失敗: " . $stmt->error;
}

$stmt->close();
$mysqli->close();
?>

輸出可能類似於：

 執行失敗: Number of variables doesn't match number of parameters in prepared statement

這個錯誤提示清晰指出了參數數量不匹配的問題。

何時使用mysqli_stmt::$error

你可以在以下幾種情況下使用該屬性進行調試：

預處理語句創建失敗時<br> 使用$mysqli->error來獲取錯誤信息
參數綁定失敗或數量不匹配時
bind_param()本身不會報錯，但如果參數數量不對，執行時$stmt->error會提示。
執行失敗時（如違反唯一約束）
例如試圖插入重複的email 時， $stmt->error會返回類似
"Duplicate entry '[email protected]' for key 'email'"的提示。

配合調試日誌使用

你還可以將錯誤信息記錄到日誌中，以便後續排查：

 if (!$stmt->execute()) {
    error_log("預處理執行錯誤: " . $stmt->error);
}

這樣可以在生產環境中避免將錯誤暴露給用戶，同時便於開發者排查問題。

實戰建議

不要只依賴return false ，一定要結合error屬性查看詳細信息。
開發階段可以直接輸出錯誤；生產環境中應記錄日誌。
搭配errno一起使用，可以獲得錯誤代碼以做更細緻的判斷。

小結

mysqli_stmt::$error是調試預處理語句過程中非常實用的工具。通過它，你可以快速知道語句為何失敗，從而加快開發效率，減少排查時間。

在開發過程中，合理使用這個屬性，將讓你的數據庫交互更加健壯可靠。