mysqli_ping() 是 mysqli 唯一靠谱的原生心跳机制,通过协议层真实检测连接状态;pdo 无内置 ping,须用 exec("select 1") 替代,且不可信的 getattribute(pdo::attr_connection_status) 应弃用。

mysqli_ping() 是唯一靠谱的原生心跳机制
MySQLi 扩展提供了 mysqli_ping(),它会向服务器发送一个轻量级 ping 包并等待响应——这是 MySQL 协议层的真实连通性检测,不是查内存状态。只要连接还挂在 TCP 上、MySQL 进程没挂、网络没中断,它就返回 true。
常见错误现象:mysqli_ping() 返回 false 但后续 mysqli_query() 又成功了?基本不可能;反而是它返回 true 后立刻 query() 报 MySQL server has gone away,说明 ping 刚过、连接就断了(比如防火墙 kill 了空闲连接),这时你得在业务 query 前再 ping 一次。
- 必须在已有有效连接句柄上调用,
mysqli_connect()失败后不能用 - 不要和
mysqli_connect_error()混用:后者只反映上一次 connect 的失败,不反映当前连接存活状态 - 在长连接池(如 Swoole Worker)中,每次从池里取出连接后必须调用一次
mysqli_ping(),别省
PDO::getAttribute(PDO::ATTR_CONNECTION_STATUS) 完全不可信
PDO::getAttribute(PDO::ATTR_CONNECTION_STATUS) 看起来像心跳接口,但它只是读 PDO 内部的一个状态标记,压根不发任何网络包。MySQL 连接因 wait_timeout 断开后,它仍可能返回 in transaction 或 idle,下一次 exec() 直接抛出 PDOException: MySQL server has gone away。
这个方法唯一能告诉你的是“PDO 对象自己觉得它还连着”,不是“MySQL 服务器还认你”。把它当心跳用,等于没测。
实操建议:删掉所有类似 if ($pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS)) { ... } 的逻辑,它解决不了任何真实问题。
PDO 必须用 exec("SELECT 1") 模拟 ping
PDO 没有内置 ping 方法,exec("SELECT 1") 是目前最轻量、最通用、权限要求最低的替代方案。它不返回结果集、不创建 PDOStatement、不走预处理流程,开销几乎为零。
容易踩的坑:
- 别用
PDO::query("SELECT 1"):它默认返回PDOStatement对象,哪怕只查一行也多一层构造开销 - 别用
SHOW TABLES:依赖SHOW DATABASES权限,某些生产环境会禁用 - 别用
SELECT NOW():ProxySQL、MaxScale 等中间件可能缓存或重写该语句,导致误判 - 捕获异常必须具体:只 catch
PDOException,且用正则匹配/gone away|Lost connection|Connection refused/i,别 catch 全局Exception
示例关键片段:
try {
$pdo->exec("SELECT 1");
} catch (PDOException $e) {
if (preg_match('/(gone away|Lost connection|Connection refused)/i', $e->getMessage())) {
// 这才是真断连,该重连或报错
throw new RuntimeException('DB heartbeat failed', 0, $e);
}
throw $e;
}
持久连接(PDO::ATTR_PERSISTENT)下 ping 失败必须重建实例
开启 PDO::ATTR_PERSISTENT 后,PHP 不会在脚本结束时真正关闭连接,而是归还给连接池复用。但一旦连接因超时或网络中断失效,exec("SELECT 1") 失败后,PDO 不会自动清理底层 socket,也不会自动重建连接。
此时你 unset $pdo 并重新 new 一个实例,PHP 才会从连接池取新连接(或新建)。光靠 try/catch + exec 并不能让旧实例“复活”。
所以持久连接场景下,心跳失败后的标准动作是:
- 显式
unset($pdo) - 重新
new PDO(...) - 再执行一次
exec("SELECT 1")验证新连接
跳过 unset 直接重 new,旧连接资源可能泄漏;不验证新连接,可能拿到另一个坏连接。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











