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

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

PHP 8.1 起，MySQLi 默认启用异常报告模式，连接失败时不再设置 connect_errno，而是直接抛出 mysqli_sql_exception，因此传统 if ($polaczenie->connect_errno) 判断失效。需改用 try-catch 捕获异常或显式关闭异常报告。

php 8.1 起，mysqli 默认启用异常报告模式，连接失败时不再设置 `connect_errno`，而是直接抛出 `mysqli_sql_exception`，因此传统 `if ($polaczenie->connect_errno)` 判断失效。需改用 `try-catch` 捕获异常或显式关闭异常报告。

在 PHP 8.1 及更高版本中，MySQLi 扩展的默认错误处理行为发生了重要变更：mysqli_report() 的默认模式已从 MYSQLI_REPORT_STRICT（实际等效于 MYSQLI_REPORT_OFF + 显式检查）调整为自动启用异常报告（即等效于 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)）。这意味着，当 new mysqli() 初始化失败（如主机不可达、认证失败、数据库不存在等），不会静默返回一个 $polaczenie 对象并设置 connect_errno，而是立即抛出 mysqli_sql_exception。因此，原代码中对 $polaczenie->connect_errno 的判断永远无法执行——因为 $polaczenie 根本未成功创建，后续访问会触发致命错误（如 Fatal error: Uncaught Error: Call to a member function connect_errno()）。

✅ 正确做法是使用异常处理机制：

<?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) {
    // 获取标准 MySQL 错误码（如 1045、2002）
    $errorCode = $e->getCode();
    // 获取可读错误信息（推荐用于调试/日志）
    $errorMessage = $e->getMessage();

    echo "Error: [{$errorCode}] {$errorMessage}";
}
?>

⚠️ 注意事项：

btpanel phpsite 宝塔面板PHP网站

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

下载

避免滥用 @ 抑制符：它会屏蔽所有错误（包括语法错误、内存限制等），不利于调试；异常机制本身已提供可控的错误处理路径。
不要依赖 $polaczenie->connect_errno 做连接判断：该属性仅在连接对象创建成功但后续操作（如查询）失败时有效；连接阶段失败由异常承载。

若需兼容旧版逻辑（如遗留项目迁移），可在连接前关闭异常报告：

mysqli_report(MYSQLI_REPORT_OFF); // 恢复传统 errno 模式
$polaczenie = new mysqli($host, $db_user, $db_password, $db_name);
if ($polaczenie->connect_errno) {
    echo "Error: " . $polaczenie->connect_errno . " - " . $polaczenie->connect_error;
}

但强烈建议采用现代异常方式，更安全、更符合 PSR-12 等编码规范。

? 总结：PHP 8.1+ 中 MySQLi 连接错误必须通过 try-catch 捕获 mysqli_sql_exception 来处理，这是官方推荐且健壮的实践方式。同时，请确保 connect.php 中的 $host、$db_user 等变量已正确定义，并对 $_POST 数据进行必要的空值校验与过滤，以提升代码安全性与鲁棒性。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！