简体中文
简体中文
在使用 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->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 是调试预处理语句过程中非常实用的工具。通过它，你可以快速知道语句为何失败，从而加快开发效率，减少排查时间。
在开发过程中，合理使用这个属性，将让你的数据库交互更加健壮可靠。
