thinkphp无内置数据库连接池，fpm下仅支持deploy=>1的pdo实例复用，真连接池仅在swoole协程中通过db::pool()显式调用生效；配置必须放在config/swoole.php中，且需满足版本和环境要求。
ThinkPHP 本身没有内置数据库连接池，所谓“实现连接池优化”，本质是根据运行环境选择匹配的复用机制——FPM 下只能靠 deploy => 1 做单请求内 PDO 实例复用；真连接池只在 Swoole 协程环境下生效，且必须走 Db::pool() 显式入口。
Db::pool() 必须显式调用，否则配置全是摆设
很多人配了 config/swoole.php 里的 db_pool 参数，但 show processlist 里连接数照涨不误。原因就一个：代码里还在用 Db::table('user')->select()，它压根不走池子。
-
Db::table('user')->select()→ 每次新建 PDO 连接（短连接） -
Db::pool()->table('user')->select()→ 从池中取空闲连接，用完自动归还 -
Db::transaction()默认绕过池子；必须写成Db::pool()->transaction(function () { ... }) - 模型类（如
UserModel）不自动继承池行为，需重写db()方法返回Db::pool()实例
config/swoole.php 才是唯一有效的池配置位置
config/database.php 里任何 pool、max_connections、pool_size 字段全被忽略——TP5/TP6/TP8 均不解析这些键。真正起作用的只有 config/swoole.php 中的 db_pool 配置段。
- 必须确保已安装
topthink/think-swoole >= 3.1.0且swoole >= 4.8.0 - 典型配置：
'db_pool' => ['max_active' => 8, 'max_idle' => 2, 'wait_timeout' => 2000, 'idle_timeout' => 60] -
max_active是硬上限，不是并发数，而是池中最多存在的连接总数 -
wait_timeout是获取连接的排队超时（毫秒），设太小（如100）会导致大量PoolTimeoutException，设太大（如5000）会让请求卡死 - FPM 模式下该配置完全无效，只对
php think swoole启动的协程进程生效
deploy => 1 是 FPM 和 Swoole 都能用的复用基础
这不是连接池，但它是所有复用的前提。它让相同数据库配置（host/port/database/user/password 完全一致）共享同一个 PDO 实例，避免重复创建对象。
- 必须显式配置
'deploy' => 1，默认是0（关闭） - 漏写
'type' => 'mysql'或把'hostname'写成'host'，都会导致复用失效 -
'pool_size' => 20仅在deploy => 1开启时限制同配置 PDO 实例数量，不控制底层 TCP 连接数 - CLI 脚本末尾必须手动调
Db::close()，否则连接常驻内存；Swoole 下同样不能依赖自动回收 - 开启
'debug' => true会强制禁用所有复用逻辑，每次查询都新建 PDO
Swoole 环境下连接泄漏比配置错误更致命
协程连接不会随请求结束自动释放，一个没关的 Db::connect() 或未提交的事务，就能让连接永久卡在池里或 MySQL 的 Sleep 状态。
- 事务必须包裹在同一个协程内：
go(function () { Db::pool()->transaction(...); });，跨协程执行会导致连接丢失 - MySQL 的
wait_timeout默认仅 8 秒，闲置连接会被服务端 kill；需同步配置'options' => ['heartbeat' => 3]并调大服务端值（SET GLOBAL wait_timeout = 300） - 禁止在
__construct、中间件或定时任务回调中提前调Db::connect()，应在go()内按需获取 - 用
spl_object_id($connection)打日志验证是否真复用：同一 worker + 同一协程内两次查询 ID 相同，才算进了池
最易被忽略的点：二级域名、多环境变量、动态传参都会破坏配置一致性，让 deploy => 1 和池复用全部失效；别盯着 pool 字段改，先统一 hostname、database、username 的拼写和大小写。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
