MySQL连接失败时如何重定向提示而非抛出致命错误？

问题原因 #

PHP 8.0及以上版本中，MySQLi默认会抛出mysqli_sql_exception异常，而不是把错误信息存入connect_error属性。这就导致你原来的if ($db->connect_error)判断逻辑根本没机会运行，程序直接因为未捕获的致命异常终止，自然没法执行重定向。

两种解决方法 #

方法一：关闭MySQLi异常模式，回到传统错误处理

在实例化MySQLi之前，关闭异常报告，让连接错误回到connect_error属性存储的方式，原有逻辑就能正常执行：

// 关闭MySQLi的异常报告模式
mysqli_report(MYSQLI_REPORT_OFF);

$db = new MySQLi($hostname, $username, $password, $database);
if ($db->connect_error) {
    header('Location: ../setup_db.php?connect_error=1');
    exit(); // 终止程序，避免后续代码执行
}
// 连接成功后的业务逻辑写在这里

方法二：捕获异常，在catch块中处理重定向

用try-catch包裹连接代码，主动捕获mysqli_sql_exception异常，在异常处理块里执行重定向，这种方式更符合现代PHP的异常处理规范：

try {
    // 确保开启异常模式（PHP8+默认已开启，手动设置更稳妥）
    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $db = new MySQLi($hostname, $username, $password, $database);
} catch (mysqli_sql_exception $e) {
    // 捕获连接异常，执行重定向
    header('Location: ../setup_db.php?connect_error=1');
    // 如果需要记录错误日志，可以加下面这行
    // error_log('数据库连接失败：' . $e->getMessage());
    exit();
}
// 连接成功后的业务逻辑写在这里

注意事项 #

• 执行header('Location: ...')之前，绝对不能有任何输出（包括空格、HTML标签、echo内容等），否则会触发headers already sent错误。如果之前有不可避免的输出，可以在代码开头加ob_start()开启输出缓冲。
• 重定向后一定要调用exit()或die()终止程序，防止后续代码继续执行。

内容的提问来源于stack exchange，提问作者liminalFrog