如何在 PHP 8.1+ 中正确捕获并显示自定义 MySQLi 连接错误信息-html教程-PHP中文网

如何在 PHP 8.1+ 中正确捕获并显示自定义 MySQLi 连接错误信息

PHP 8.1 起，MySQLi 默认启用异常报告模式（MYSQLI_REPORT_ALL），连接失败时会直接抛出 mysqli_sql_exception，而非设置 $mysqli->connect_errno，导致传统错误检查逻辑失效。需改用 try-catch 捕获异常或显式关闭异常报告。

php 8.1 起，mysqli 默认启用异常报告模式（`mysqli_report_all`），连接失败时会直接抛出 `mysqli_sql_exception`，而非设置 `$mysqli->connect_errno`，导致传统错误检查逻辑失效。需改用 try-catch 捕获异常或显式关闭异常报告。

在 PHP 8.1 及更高版本中，MySQLi 扩展的默认行为发生了重要变更：mysqli_report() 的默认值已从 MYSQLI_REPORT_OFF 改为 MYSQLI_REPORT_ALL。这意味着——任何连接、查询或准备语句失败，都会立即抛出 mysqli_sql_exception 异常，而不再静默设置 $mysqli->connect_errno 或 $mysqli->errno 属性。因此，你原代码中依赖 if ($polaczenie->connect_errno != 0) 的判断将永远无法执行（因为连接失败时对象根本不会被成功创建，或异常已中断流程），自然看不到自定义错误输出。

✅ 正确做法是使用结构化异常处理：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php require_once "connect.php";

try {
    // @ 符号在此处已无实际意义（异常无法被@抑制），可移除
    $polaczenie = new mysqli($host, $db_user, $db_password, $db_name);

    // 连接成功后处理业务逻辑
    $login = $_POST['login'] ?? '';
    $haslo = $_POST['haslo'] ?? '';

    echo "It works!";

    $polaczenie->close();
} catch (mysqli_sql_exception $e) {
    // 获取标准错误码（如 1045、2002）和消息
    echo "Error: [" . $e->getCode() . "] " . htmlspecialchars($e->getMessage());
}
?>

⚠️ 注意事项：

@new mysqli(...) 中的错误抑制符 @ 对异常无效，应移除以避免掩盖调试信息；
始终对用户输出的错误信息做 htmlspecialchars() 处理，防止 XSS；

若需兼容旧版逻辑（不使用异常），可在连接前显式关闭异常报告：

mysqli_report(MYSQLI_REPORT_OFF); // 必须在 new mysqli 前调用
$polaczenie = new mysqli($host, $db_user, $db_password, $db_name);
if ($polaczenie->connect_error) {
    echo "Error: " . $polaczenie->connect_error;
}