frankenphp worker模式下pdo连接不自动重连,因doctrine dbal健康检查仅限cli且仅显式ping触发;需在每次查询前执行select 1探活并捕获2006/2013错误重建连接,同时重置会话变量并加锁防并发冗余重连。

FrankenPHP worker 模式下,PDO 连接常驻内存,MySQL wait_timeout(默认 8 小时)一过,连接就静默失效;下次执行 executeStatement() 直接抛 PDOException: SQLSTATE[HY000] [2006] MySQL server has gone away —— 不会自动重连,必须由应用层显式干预。
Doctrine DBAL 在 FrankenPHP 中不触发健康检查
Doctrine 默认只在 CLI 环境下响应 doctrine:database:ping 命令调用 ping(),Web 请求生命周期中完全跳过这一步。它假设每次请求都从零开始(如 PHP-FPM 那样),但 FrankenPHP 的 worker 是长驻的,PDO 实例复用,状态不会自动刷新。
- DBAL 的
ping()方法本身是空操作(除非你手动重写Connection类),不真正发探活语句 - 即使配置了
doctrine.dbal.options.health_check_delay=0,也仅影响连接池预热逻辑,不改变请求中是否主动探测 - 不能依赖
isConnected():它只查 PDO 内部标记,不验证真实网络可达性
必须在查询前做连接有效性验证
最稳妥的方式是每次执行 SQL 前,先执行一条轻量语句(如 SELECT 1)探活;失败则重建连接。Doctrine 不提供开箱即用的钩子,需在 Repository 或自定义 ConnectionWrapper 中注入逻辑。
- 避免在事务中探活:
SELECT 1会隐式提交当前事务(如果 autocommit=false),应先判断$connection->isTransactionActive() - 不要用
$pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS):PHP 7.4+ 返回值不可靠,常为unknown - 重建连接后,记得重置会话变量,例如
SET NAMES utf8mb4、SET time_zone = '+00:00',否则字符集或时区可能错乱
重连逻辑必须配合连接生命周期管理
FrankenPHP worker 启动时初始化连接,但不能任其无限复用。需要明确“何时销毁旧连接”——不是等异常发生才处理,而是主动控制。
- 在
onWorkerStart(或 Symfony Kernel Boot 后)初始化PDO实例,并存入容器或静态属性 - 捕获
2006/2013错误后,先unset($oldPdo)或设为null,再 new 新实例,防止旧连接句柄滞留 - 多个并发请求同时触发重连时,加锁(如
flock文件锁或 Redis 分布式锁),避免创建冗余连接压垮 MySQL 的max_connections - 别把重连逻辑塞进 Doctrine 的
EventManager:事件监听器无法中断已失败的 query 流程,只能事后记录,起不到恢复作用
真正的难点不在“怎么重连”,而在于“什么时候该放弃当前连接、什么时候该新建、以及新建之后如何保证上下文一致”。FrankenPHP 的常驻特性让连接状态变成一个需要主动管理的状态机,而不是无感的资源——任何一次 execute() 都可能失败,必须按错误码分类处理,且不能假设重连后一切如初。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











