thinkphp数据库连接池生效需同时满足swoole环境（≥v4.8.0）与think-swoole扩展（≥v3.1.0），配置须在config/swoole.php的database节点下启用enable=true，并显式调用db::pool()方法，否则仍走短连接。
如果您在ThinkPHP中启用数据库连接池但实际请求仍走短连接，说明配置未生效或调用方式错误。以下是设置数据库连接池的具体方法：
一、确认运行环境与扩展依赖
连接池功能并非ThinkPHP原生能力，必须满足两个硬性前提：运行于Swoole协程环境（≥v4.8.0），且已安装并启用think-swoole扩展（≥v3.1.0）的db_pool模块。FPM模式下所有pool配置均被忽略，Db::pool()调用将退化为普通Db::connect()。
1、执行php --ri swoole检查Swoole版本及协程支持状态，确认support coroutines => enabled；
2、运行composer show topthink/think-swoole验证扩展已安装且版本不低于3.1.0；
3、在config/swoole.php中确认'db_pool' => true已开启（部分版本需显式启用）。
二、正确配置连接池参数
连接池配置必须写入config/swoole.php的database节点，而非config/database.php。后者添加任何pool字段均无效，框架完全不读取。
1、打开config/swoole.php，在'database'数组中添加以下配置：
2、设置'enable' => true，该字段为开关，若为false则全部参数被忽略，强制走短连接；
3、指定'min_connections' => 5，表示Worker启动时预热创建5个空闲连接，避免首请求延迟；
4、设定'max_connections' => 50，表示单个Worker进程内池子最大连接总数（空闲+忙碌），不是全局上限，而是每Worker独立上限；
5、配置'wait_timeout' => 3.0，单位为秒，协程等待空闲连接超时后抛出ConnectionPoolTimeoutException；
6、加入'heartbeat' => 30，表示每30秒向MySQL发送心跳包检测连接存活状态。
三、强制使用池化连接的调用方式
即使池已启用，90%的常见查询仍会绕过池逻辑，因其默认调用的是非池化Db实例。必须显式使用Db::pool()返回的池化对象发起操作，否则连接永不进入池管理。
1、正确写法：Db::pool()->table('user')->where('id', 1)->find()，必须以Db::pool()开头，不可省略；
2、事务必须改写为：Db::pool()->transaction(function () { ... })，原Db::transaction()不走池；
3、模型类中不能直接调用self::where()，需重写db()方法返回Db::pool()，或在查询时手动注入：new UserModel(['db' => Db::pool()])；
4、读写分离场景下，Db::connect('slave')不进池，必须使用Db::pool()->connect('slave')。
四、验证连接池是否真实生效
仅靠配置文件修改无法确认池是否工作，必须通过运行时行为验证。关键指标是同一协程内多次获取PDO句柄是否复用相同底层连接。
1、在控制器中插入调试代码：var_dump(get_class(Db::pool()));，输出应为think\swoole\pool\DatabasePool，若为think\db\Connection则未启用池；
2、在同一个协程内连续两次调用：$pdo1 = Db::pool()->getPdo(); $pdo2 = Db::pool()->getPdo();；
3、打印spl_object_id($pdo1)与spl_object_id($pdo2)，若ID相同，说明连接被复用；若不同，则仍在新建连接；
4、观察MySQL侧连接数变化：执行show status like 'Threads_connected';，高并发压测时该值应稳定在max_connections × worker_num附近，而非持续飙升。
五、对齐三层资源限制避免阻塞
连接池生效后QPS仍上不去，往往因MySQL、Swoole Worker、协程并发量三者未对齐，导致连接排队或拒绝服务。
1、检查MySQL全局最大连接数：show variables like 'max_connections';，其值必须≥max_connections配置值 × swoole.server.worker_num；
2、确认Swoole Worker数量：config/swoole.php中'worker_num'不得低于预期并发压力，设为2则最多仅2个进程能并发取连接；
3、控制协程并发量：避免单个Worker内启动远超max_connections的协程数，例如池上限为8却启200协程，将有192个协程等待超时；
4、在控制器中打印Swoole\Coroutine\Channel当前长度，可直观反映连接排队情况，长度持续大于0即存在阻塞。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
