Hyperf数据库连接断开后不自动重连，核心是启用heartbeat机制提前剔除无效连接：需设'heartbeat' => true且'max_idle_time'严格小于MySQL的wait_timeout，否则连接池会复用已被服务端关闭的连接导致“MySQL server has gone away”错误。
Hyperf数据库连接断开后不自动重连？先确认是否启用了心跳机制
Hyperf 默认使用 Swoole\Coroutine\MySQL 或 pdo_mysql 协程驱动，但**连接池本身不会主动探测或修复失效连接**。所谓“断开后重连失败”，往往是因为旧连接被服务端（如 MySQL）主动踢掉（wait_timeout 超时），而连接池仍把它当有效连接返回给业务代码，导致首次查询报错：MySQL server has gone away。
解决核心不是“重连”，而是“提前发现并剔除无效连接”——这正是 heartbeat 的作用：它在连接归还到连接池前，执行一条轻量 SQL（如 SELECT 1）验证连接可用性。
必须满足两个条件才生效：
-
pool.max_idle_time必须小于 MySQL 的wait_timeout（例如设为86000，MySQL 设为86400） -
pool.heartbeat必须显式开启（默认是false）
如何正确配置 heartbeat 参数（hyperf/database v2.x / v3.x）
配置位置在 config/autoload/databases.php 中对应数据库的 pool 项下。注意：这不是全局开关，每个数据库连接池需单独配。
关键参数及建议值：
-
'heartbeat' => true：必须设为true，否则不触发检测 -
'max_idle_time' => 86000：单位毫秒，建议比 MySQLwait_timeout少 30–60 秒，留出网络与执行余量 -
'min_connections' => 1：可选，避免空闲时全部销毁，但非 heartbeat 必需 -
'timeout' => 5.0：连接获取超时，和 heartbeat 无关，但影响故障感知速度
示例片段：
'mysql' => [
'driver' => 'mysql',
'host' => env('DB_HOST', 'localhost'),
'port' => env('DB_PORT', 3306'),
'database' => env('DB_DATABASE', 'hyperf'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'pool' => [
'min_connections' => 1,
'max_connections' => 32,
'connect_timeout' => 10.0,
'wait_timeout' => 3.0,
'heartbeat' => true,
'max_idle_time' => 86000,
],
],
heartbeat 不生效的三个典型原因
即使配置了 heartbeat => true，仍可能“看起来没用”，常见于以下场景：
-
max_idle_time≥ MySQL 的wait_timeout：连接在池中还没到心跳检查点就被服务端断开了，心跳根本没机会执行 - 使用了
Db::raw()或原生 PDO 操作绕过连接池：heartbeat 只对连接池管理的连接起作用，直连或手动 new PDO 不受控 - 错误发生在连接获取阶段（如 DNS 解析失败、TCP 连不上）：heartbeat 检测的是“已建立但失效的连接”，不处理建连失败
验证是否生效：在 MySQL 开启 general_log，观察应用归还连接前是否有 SELECT 1 日志；或在 max_idle_time 后故意让连接超时，看下次取连接是否抛异常再重建。
为什么不用 ping() 或更激进的健康检查？
Hyperf 的 heartbeat 固定执行 SELECT 1，而非调用 mysqli_ping() 或 PDO::getAttribute(PDO::ATTR_CONNECTION_STATUS)，原因很实际：
-
ping()在某些 MySQL 配置下（如禁用skip-networking或 proxy 环境）行为不稳定，可能误判 -
SELECT 1是最通用、最低开销、且能同时验证协议层与 SQL 层可用性的操作 - 连接池设计目标是“轻量复用”，不是“全链路探活”，过度检测会拖慢吞吐
如果你的应用需要更高强度保活（比如长周期定时任务），应在业务层做兜底：捕获 Hyperf\Database\Exception\QueryException 中含 server has gone away 的情况，再手动 DB::reconnect() 或重试逻辑。
真正容易被忽略的是：heartbeat 只在连接「归还」时触发，不是「取出」时。这意味着刚从池里拿到的连接，如果已在服务端静默断开，第一次查询仍会失败——这不是 bug，是设计权衡。要覆盖这个窗口，得靠 max_idle_time 严控 + 业务层异常重试。
