ThinkPHP原生连接池无健康检查与自动重试机制；需手动实现心跳检测（如重写getPdo()执行SELECT 1）、失败计数、连接剔除及重建闭环。
ThinkPHP 连接池健康检查失败后不自动重试？
默认情况下，ThinkPHP 的数据库连接池（基于 PDO + 连接复用）本身不内置心跳检测或失败重试逻辑。所谓“心跳失败多次才标记异常”，其实是开发者在 think\db\Connection 或中间件/配置层手动叠加的行为，并非框架原生能力。
真正起作用的是：break_reconnect 配置项（控制断连后是否尝试重建连接），以及你是否在 think\db\connector\Mysql 等具体驱动中覆盖了 initConnect() 或重写了 getPdo() —— 否则，一次 PDOException 就直接抛出，根本不会“失败多次再标记”。
-
break_reconnect = true：仅在查询执行时捕获 PDO 异常后，尝试新建一个连接并重试当前 SQL（仅限单次重试，不支持“连续失败 N 次才下线”） - 连接池中的连接是否被标记为“异常”并剔除，取决于你是否实现了
think\db\Pool的自定义回收逻辑（如重写recycle()方法） - 原生
think\db\Pool不做连接可用性预检，get()返回的连接可能已失效（比如 MySQL wait_timeout 触发后）
如何让 ThinkPHP 在获取连接前做心跳检测？
必须手动干预连接获取流程。推荐在自定义数据库连接类中重写 getPdo()，在返回 PDO 实例前主动执行一次轻量心跳（如 SELECT 1），失败则抛异常触发重连或剔除逻辑。
class HealthCheckMysql extends \think\db\connector\Mysql
{
public function getPdo($config = [])
{
$pdo = parent::getPdo($config);
// 心跳检测：只对已存在的连接做验证，避免首次连接时重复执行
if ($this->isConnected() && !$this->ping($pdo)) {
throw new \think\db\exception\PDOException('DB connection heartbeat failed');
}
return $pdo;
}
protected function ping($pdo): bool
{
try {
$stmt = $pdo->prepare('SELECT 1');
$stmt->execute();
return (bool) $stmt->fetchColumn();
} catch (\Throwable $e) {
return false;
}
}
}
然后在数据库配置中指定驱动类：'type' => HealthCheckMysql::class。注意：该方式会在每次 getPdo() 调用时增加一次 round-trip，高并发下需权衡延迟与可靠性。
立即学习“PHP免费学习笔记（深入）”；
连接池里“标记异常连接”要自己实现剔除逻辑
ThinkPHP 的 think\db\Pool 默认只是个对象缓存容器，没有“健康状态”字段，也不会因异常自动移除连接。要实现“失败 N 次后下线”，得配合自定义连接包装器和计数器。
- 继承
think\db\Connection，添加$failCount属性和incFailCount()方法 - 在自定义
query()/execute()中捕获异常后调用incFailCount()，若 ≥3 次，则调用$pool->remove($this) - 确保连接归还时调用
recycle()，并在其中重置$failCount = 0（否则成功后仍会累积） - 不要依赖
__destruct清理，因为连接对象可能被池长期持有
关键点：池本身不管理连接状态，所有状态逻辑必须由连接实例自身携带并主动上报。
为什么配置了 break_reconnect=true 却没看到重试日志？
因为 break_reconnect 只在 query() 和 execute() 内部的 try...catch 中生效，且仅重试同一条 SQL，不是“重试获取连接”。如果你在 Db::connect() 后手动调用了 $conn->getPdo() 并出错，这个异常根本不会进入重连流程。
- 重试只发生在
Connection::query()方法体内的 PDO 操作异常时 - 如果异常来自事务开启、预处理绑定、或连接初始化阶段（如
connect()），break_reconnect完全不触发 - 查看是否误将异常捕获在了外层（比如中间件里吞掉了 PDOException），导致框架没机会处理
- 开启
debug模式后，可监听DbQuery和DbQueryError事件确认重试是否发生
真正需要连接级弹性时，别只靠配置，得把心跳、计数、剔除、重建这几步串成闭环——而 ThinkPHP 只提供了拼图的一小块。
