PHP 8 中 mysqli 默认不抛异常,仍需手动启用 report_mode;PDO 自 8.0 起默认 ERRMODE_EXCEPTION。mysqli_connect() 失败时强制抛异常,后续操作则严格依赖 mysqli_report() 设置。

PHP 8 中 mysqli 并没有改变默认错误模式 —— 它从来就没有“自动抛出异常”的默认行为。真正发生变更的是 PDO:从 PHP 8.0 开始,PDO::ATTR_ERRMODE 默认值从 PDO::ERRMODE_SILENT 切换为 PDO::ERRMODE_EXCEPTION。而 mysqli 仍维持原状:出错只设 $mysqli->errno 和 $mysqli->error,不抛异常,除非你主动启用。
mysqli 默认不抛异常,必须手动开启 report_mode
很多人误以为 mysqli 在 PHP 8 里也“自动异常化”了,其实它连默认报错都靠你手写 if (!$result) { die($mysqli->error); }。要让它像 PDO 那样一出错就 throw mysqli_sql_exception,得显式设置:
-
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)(全局生效,推荐在连接前调用) - 或
$mysqli->options(MYSQLI_OPT_REPORT, MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)(仅对当前连接)
注意:MYSQLI_REPORT_STRICT 单独使用无效,必须和 MYSQLI_REPORT_ERROR 组合;否则仍静默失败。另外,mysqli_driver::$report_mode 自 PHP 8.1 起已弃用,别再用对象属性方式设置。
为什么 mysqli_connect() 失败时总抛异常,但后续查询却不抛?
这是唯一一个“绕过 report_mode”的例外:mysqli::__construct() 和 mysqli_connect() 在连接失败时,无论是否开启 MYSQLI_REPORT_STRICT,都会直接抛 mysqli_sql_exception。但一旦连接成功,所有后续操作(如 query()、prepare()、execute())就严格遵循 report_mode 设置 —— 如果没开,它们就只返回 false,并更新 $mysqli->errno。
常见踩坑点:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 写了
mysqli_report(MYSQLI_REPORT_ALL),但忘了它包含MYSQLI_REPORT_INDEX等非关键项,反而让低优先级警告也触发异常 - 在 CLI 脚本里开了 strict,但 Web 环境里没开,导致线上查不到错、本地却崩得莫名其妙
- 用
mysqli::execute_query()(PHP 8.2+)时,它内部会强制检查错误,但依然不会抛异常 —— 除非你提前设置了 report_mode
PDO 和 mysqli 的错误处理不能混着假设
PDO 的 PDO::ERRMODE_EXCEPTION 是深度集成的:只要属性设了,所有方法(包括 prepare()、execute()、beginTransaction())出错一律抛 PDOException。而 mysqli 的异常机制是“补丁式”的,只覆盖部分函数,且依赖外部开关。比如:
-
$mysqli->query("DROP TABLE nonexistent")→ 若未开MYSQLI_REPORT_STRICT,返回false,$mysqli->errno === 1051 -
$pdo->exec("DROP TABLE nonexistent")→ 默认就抛PDOException,无需额外配置
更隐蔽的是字符集问题:MySQL 8 默认 caching_sha2_password 或 utf8mb4 字符集不兼容旧 mysqlnd 时,mysqli_connect() 抛的异常类型是 mysqli_sql_exception,但错误信息里可能含 Server sent charset unknown to the client 或 authentication method unknown to the client —— 这类底层握手失败,report_mode 根本没机会起作用。
真正容易被忽略的,是 report_mode 的作用域边界:它不继承、不跨连接、不进子进程,而且一旦在某个连接上设置,就不能 runtime 关闭(只能重连)。如果你在长生命周期服务(如 Swoole Worker)里动态切换它,得格外小心连接复用带来的状态污染。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










