ThinkPHP如何做数据库连接池预热脚本_ThinkPHP启动后主动建立连接【操作】-ThinkPHP-PHP中文网

ThinkPHP启动时连接池未预热会导致高并发下首次请求卡顿，需在配置加载后、路由接管前对各数据库连接及Swoole连接池分别执行真实连接并启用心跳保活。

thinkphp如何做数据库连接池预热脚本_thinkphp启动后主动建立连接【操作】

ThinkPHP 默认是懒加载连接，Db::connect() 第一次调用才建连接，服务刚启动就扛高并发时容易卡在连接建立阶段。预热脚本本质不是“启动前连”，而是“启动后立刻执行一次真实连接并保持住”。

实操建议：

在应用初始化完成、路由未接管前插入预热逻辑，比如 app\common\Bootstrap.php 的 bootstrap() 方法末尾
不要用 Db::query('SELECT 1') —— 它可能走 PDO 预处理缓存路径，不真正校验连接有效性；改用 Db::raw('SELECT 1') + ->fetch() 触发真实执行
对多数据库配置（如 mysql_read / mysql_write），需分别调用 Db::connect('mysql_read') 和 Db::connect('mysql_write')，否则只热了默认库
如果用了连接池（如 Swoole + think-swoole 扩展），光 Db::connect() 不够，得配合 ConnectionPool::get() 拿一次连接再放回，否则池子还是空的

这说明预热时数据库还没就绪，但脚本已强行执行。ThinkPHP 启动流程中，Bootstrap 比配置加载早，若数据库地址写在 .env 或动态配置里，此时可能未加载完毕。

实操建议：

把预热逻辑挪到 app\service\InitService.php 这类「服务初始化」位置，在 think\Container 完成绑定、配置已加载之后再执行
加简单重试：用 for ($i = 0; $i query('SELECT 1'); break; } catch (\PDOException $e) { usleep(500000); } }
避免在 command 命令里做预热 —— 命令行模式下 Db 实例可能未按 Web 模式初始化，连接参数缺失

WorkerStart 是进程级事件，每个 Worker 进程启动时都得单独预热，否则只有第一个 Worker 有连接，其他 Worker 仍会首次请求时阻塞建连。

实操建议：

在 SwooleEvent::onWorkerStart 回调里调用预热逻辑，且确保该回调注册在 think-swoole 的 Server::init() 之后
别复用 Web 环境下的 Db::connect() 实例 —— Swoole 下连接要绑定到当前协程或进程，必须显式调用 Db::connect($config, true) 的第二个参数 true 强制新建连接
检查 database.php 中 'deploy' => 2（读写分离）或 'pool' => true 是否开启，否则 think-swoole 不会启用连接池管理

MySQL 默认 wait_timeout=28800（8 小时），但连接池里的空闲连接可能被中间件（如阿里云 RDS 代理）、防火墙或 PHP 进程自身提前断开，导致“看似热了，实际失效”。

实操建议：

在连接池配置里加心跳：Swoole 连接池需设置 'ping_time' => 60（单位秒），每分钟发一次 PING 包保活
ThinkPHP 自身不维护连接池心跳，所以不能只依赖 Db::connect() 返回的对象，得靠底层池管理器（如 think\swoole\pool\MysqlPool）的 createObject() 和 validate() 方法介入
线上务必检查 show processlist，确认预热连接状态是 Sleep 而非 Connect 或直接消失 —— 如果是后者，大概率是网络层中断，得查安全组、RDS 白名单或 proxy 超时设置