ThinkPHP连接池无心跳检测，需在每次SQL执行前调用$connection->ping()确保连接活跃；推荐通过Db::event('before_execute')统一处理，并配置'break_reconnect'=>true实现自动重连。
ThinkPHP 连接池里没有心跳检测，ping() 得自己调
ThinkPHP 默认不维护数据库连接的活跃性，mysqlnd 或 pdo_mysql 的底层连接一旦空闲超时（比如 MySQL 的 wait_timeout=60），下次用时直接报 MySQL server has gone away。这不是 ThinkPHP 的 bug，是连接复用场景下的共性问题——它不会自动在空闲时发 PING。
真正能用的方案，是在每次获取连接后、执行 SQL 前，显式调一次 $connection->ping()。这个方法会触发底层 PING 命令，失败则重建连接。
-
ping()返回true表示连接可用；返回false时 ThinkPHP 会自动重连（前提是配置了'break_reconnect' => true） - 别依赖构造函数或初始化时的单次检测，必须在每次使用前做
- 不是所有驱动都支持
ping()，pdo_sqlite就不支持，但mysql和pdo_mysql都支持
怎么在查询前统一插入 ping()？用 Db::event('before_execute')
ThinkPHP 6.1+ 支持数据库事件钩子，before_execute 是最合适的切入点——它在预处理语句前触发，且能拿到当前连接实例。
在 app/common.php 或服务提供者中注册：
立即学习“PHP免费学习笔记（深入）”；
Db::event('before_execute', function ($query) {
$connection = $query->getConnection();
if (method_exists($connection, 'ping') && !$connection->ping()) {
// ping 失败，强制刷新连接（触发重连）
$connection->close();
}
});
- 不要用
after_connect：只在新建连接时触发，无法覆盖连接空闲后失效的场景 - 避免在模型的
initialize()里写，那只是类加载时机，不是连接使用时机 - 如果用了读写分离，需确保主从连接都注册该事件（
Db::master()和Db::slave()各自独立触发）
wait_timeout 和应用层检测间隔根本不是一回事
MySQL 的 wait_timeout 是服务端断连阈值，ThinkPHP 的连接池不会主动去“对齐”它。你设成 300 秒，不代表应用每 300 秒必须 ping 一次——而是只要某次查询前发现连接已断，就该当场处理。
- 设太短（如 5 秒）反而增加无谓开销，
ping()是网络往返，不是内存操作 - 设太长（如 600 秒）等于放任错误发生，用户请求直接 500
- 真实节奏由业务请求频次决定：高并发服务自然高频检测；后台定时任务可能几分钟才一次，那就靠第一次查询前的
ping()拦住 - 别试图用
Timer或crontab定期 ping 空闲连接——连接池里的连接没 API 可枚举，你也拿不到它们的引用
生产环境要注意 break_reconnect 必须为 true
很多线上问题其实卡在这一个配置上。默认情况下，ThinkPHP 在连接异常时抛出异常而不是重试，ping() 失败后若不重连，后续 SQL 直接崩。
- 确认数据库配置里有：
'break_reconnect' => true - 同时建议配
'reconnect_num' => 3，避免瞬时抖动导致永久失败 - 如果用了连接池（
'pool_size' > 1），每个池内连接都独立受此配置控制 - 注意：开启重连后，事务中的连接失效会导致事务中断，
ping()不应在事务中间执行（所以before_execute是安全的，它在事务 begin 之后、SQL 执行之前）
连接健康这事，没有银弹。检测动作本身要轻，触发时机要准，失败响应要稳——漏掉任意一环，都会在凌晨三点把你叫醒。
