FrankenPHP worker模式下DB::reconnect()无效，因其仅重连默认连接，不处理Eloquent模型或查询构建器中已缓存的连接实例，且事务中调用会破坏一致性；真正有效方案是在SQL执行前通过StatementPrepared事件监听+connected()检查+reconnectIfMissing()按需重连，并同步调小MySQL wait_timeout（≤300）、禁用PDO持久连接、为队列/定时任务单独配置重连逻辑。
FrankenPHP 的 worker 模式下，Laravel 不会自动重连断开的数据库连接，必须显式干预；否则首次请求成功、后续请求报 SQLSTATE[HY000] [2006] MySQL server has gone away 是常态。
为什么 worker 模式下 DB::reconnect() 不能直接用
FrankenPHP 启动 worker 后，每个 PHP worker 进程常驻，PDO 连接对象被复用——但 Laravel 的 DB::reconnect() 只重连默认连接，不处理已缓存的连接实例（如 Eloquent 模型内部持有的连接、查询构建器缓存的 $connection 对象）。更关键的是：事务中调用 DB::reconnect() 会破坏一致性，框架不会帮你 rollback 已开始的事务。
常见错误现象：
- 接口偶发 500，日志里反复出现
PDOException: SQLSTATE[HY000] [2006] - 手动在控制器开头加
DB::reconnect()，但模型查询仍失败 - 队列任务跑着跑着卡住，查日志发现连接已断，但没触发重试逻辑
worker 模式下真正生效的重连方案
核心思路：不在请求入口“补漏”，而是在每次实际执行 SQL 前做连接健康检查 + 按需重连。Laravel 的 Illuminate\Database\Connection 提供了 reconnectIfMissing() 和 connected()，但它们默认不启用；需通过事件监听或查询构建器拦截来激活。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 监听
Illuminate\Database\Events\StatementPrepared事件，在 SQL 执行前检查连接状态：if (! $connection->connected()) { $connection->reconnect(); } - 避免在
AppServiceProvider::boot()中全局注册该监听——它会影响所有连接（包括测试、命令行），应限定只对mysql连接生效 - 不要依赖
DB::reconnect()返回值判断是否成功：它可能静默失败（比如 MySQL 正在重启），需配合try/catch PDOException做 fallback - 若使用读写分离，
read和write连接需分别检查，不能只 reconnect 默认连接
配置层必须同步调整的三项
光靠代码重连不够，MySQL 侧和 Laravel 配置必须收敛到 worker 生命周期节奏：
- MySQL 的
wait_timeout必须设为 ≤ 300（5 分钟）：FrankenPHP worker 常驻，空闲连接不释放，靠服务端主动踢更可靠 - Laravel
config/database.php中 mysql 配置的'options' => [PDO::ATTR_TIMEOUT => 3]：防止连接建立卡死，阻塞整个 worker - 禁用
PDO::ATTR_PERSISTENT：worker 模式本身已是长连接，再开持久连接会导致连接数翻倍且状态污染，'options' => [PDO::ATTR_PERSISTENT => false]显式声明
最容易被忽略的坑：队列与定时任务
FrankenPHP worker 模式默认只接管 HTTP 请求，php artisan queue:work 或 schedule:run 仍是独立 CLI 进程——它们不受上述监听逻辑影响，且默认 wait_timeout 更低（云数据库常设 60 秒）。必须单独处理：
- 在
App\Console\Kernel::schedule()中为每个命令 wrap 一层重连 wrapper：$schedule->command('app:sync')->before(function () { DB::reconnect(); }); - 队列 worker 启动时加
--tries=3 --delay=1，并在failed()方法里捕获2006/2013错误码后标记为可重试 - 切勿在队列任务里调用
DB::disconnect()：CLI 进程短命，断开后无重连机制，直接报错
worker 模式不是把 FPM 换个二进制就完事——连接生命周期从“每请求一建一毁”变成“每 worker 一建多用”，所有数据库交互逻辑都得按这个新节奏重校准。最危险的不是连不上，而是连上了但用的是一个被 MySQL 无声关闭、PDO 却没感知的“僵尸连接”。
