根本原因是PDO实例持有失效socket且不自动重连,ThinkPHP的break_reconnect仅在PDO::ERRMODE_EXCEPTION开启且捕获到2002/2013/1040类错误时生效,事务中需全新启动而非复用上下文,Swoole等长连接场景须手动ping检测与重建。

PHP 程序在数据库重启后连接失败,根本原因不是“没重连”,而是默认不重连、也不自动重建连接对象——PDO 实例一旦创建,就持有底层 socket,服务端重启会让这个 socket 失效,后续任何 query 或 execute 都会抛出 PDOException(如 SQLSTATE[HY000] [2006] MySQL server has gone away),但框架或原生 PDO 不会主动感知并重连。
为什么 break_reconnect => true 没生效?
ThinkPHP 的 break_reconnect 仅在查询执行阶段捕获到 PDO 异常时触发重连,但它有三个硬性前提:
-
PDO::ATTR_ERRMODE必须设为PDO::ERRMODE_EXCEPTION,否则异常被静默忽略,break_reconnect根本没机会运行 - 只对连接层错误有效(如
2002、2013、1040),语法错误、主键冲突等业务异常不会触发 - 事务中失败直接 rollback,不会重连;Swoole 长连接或连接池场景下,该配置可能被绕过
手动重试必须区分错误类型
不是所有 PDOException 都值得重试。盲目重试账号密码错误或权限不足,只会放大问题。关键看 $e->getCode():
- 可重试:
'2002'(Can't connect)、'2013'(Lost connection)、'1040'(Too many connections) - 不可重试:
'1045'(Access denied)、'1049'(Unknown database)、'1146'(Table doesn't exist)
示例判断逻辑:
立即学习“PHP免费学习笔记(深入)”;
if ($e instanceof PDOException) {
$code = $e->getCode();
if (!in_array($code, ['2002', '2013', '1040'])) {
throw $e;
}
}
事务内重试要重开事务,不能复用上下文
事务中查询失败触发 rollback 后,当前 Db::transaction 上下文已销毁。若在 catch 里直接再调一次 Db::transaction,会报 There is no active transaction。
- 必须把整个事务块包进重试循环
- 每次重试都调用全新
Db::transaction,不能传入已有连接或事务句柄 - 重试间隔用
usleep(100000)(100ms),最多 2~3 次,避免雪崩
正确写法:
for ($i = 0; $i < 3; $i++) {
try {
Db::transaction(function () {
Db::table('order')->where('id', 123)->update(['status' => 'paid']);
});
break;
} catch (\think\db\exception\PDOException $e) {
if ($i === 2) throw $e;
usleep(100000);
}
}
连接池/Swoole 场景下不能依赖 break_reconnect
长连接模式下,连接对象被复用,break_reconnect 的“断开即重建”逻辑失效。此时需监听连接关闭事件,手动重建:
- Swoole 中监听
onClose,清空连接缓存,下次请求重新初始化PDO - 自研连接池需在
get()时做ping检测,失败则reconnect()并重试获取 - 不要假设框架配置能覆盖所有部署形态——容器重启、K8s Pod 飘移、MySQL 主从切换都会让“静态配置”失灵
最易被忽略的一点:重试日志必须记录错误码和重试次数。没有日志,你永远分不清是网络抖动还是数据库真宕了。



















