laravel框架本身不提供数据库连接池,因php-fpm无状态进程模型无法跨请求复用连接;仅在swoole/roadrunner等常驻内存环境中才支持真正连接池,mongodb驱动除外。

Laravel 框架本身不提供数据库连接池,无论你怎么配 config/database.php,只要跑在 PHP-FPM 下,就不可能有真正意义上的连接池——这是由 PHP 的无状态进程模型决定的。
PHP-FPM 场景下“连接池”根本不存在
很多人在 config/database.php 里加 'pool' => ['enabled' => true] 或 'sticky' => true,结果发现完全没用。这不是你配错了,是 Laravel 当前版本(包括 10.x/11.x)压根没读取这些键。翻源码就能确认:vendor/laravel/framework/src/Illuminate/Database/DatabaseManager.php 中搜索 sticky,只出现在注释和测试里;pool 更是纯占位字段,框架逻辑中零调用。
- 所谓“复用”,仅限单次请求内:同一个
DB::connection()实例多次查询会共用一个 PDO 对象,但请求一结束,连接就关闭(除非开了持久连接) -
PDO::ATTR_PERSISTENT => true确实能让 FPM worker 进程复用底层 TCP 连接,但副作用明显:事务残留、用户变量污染、临时表未清理,极易引发数据错乱 - 错误现象如
SQLSTATE[HY000] [1040] Too many connections,根源是 FPM 子进程数 × 并发请求数打满了 MySQL 的max_connections,不是 Laravel “没配池”
Swoole / RoadRunner 场景下才谈得上配连接池
只有当你已切换到常驻内存运行模式(比如用 swooletw/laravel-swoole 或 Laravel Octane),每个 Worker 进程能长期存活,协程才能调度一组长连接复用,这时“连接池”才有实际意义。
- MySQL 配置中必须把
host改成 IP(如127.0.0.1),不能写localhost,否则 Swoole 会走 Unix socket,导致连接池失效 - 需显式配置连接池参数,例如在
config/database.php的 MySQL 连接块中加入:'options' => [PDO::ATTR_TIMEOUT => 5]防卡死,'read' => [...], 'write' => [...]分离读写节点 - 不要依赖
DB::reconnect():它只是断开重连,不恢复事务上下文,高并发下反而加剧连接抖动
MongoDB 是少数真支持连接池的场景
Laravel MongoDB 驱动(基于官方 PHP 扩展)底层由 MongoDB C driver 管理连接池,maxPoolSize 和 minPoolSize 是真实生效的配置项。
- 生产环境建议从
maxPoolSize => 15、minPoolSize => 5起步,根据 CPU 核心数和压测 QPS 调整 - 务必开启
'persistConnection' => true,否则每次请求仍会重建连接+认证,失去池化价值 - 注意
socketTimeoutMS(建议 30000)和connectTimeoutMS(建议 10000)要设合理,避免慢查询拖垮整个池
比“配池”更关键的是绕过池的限制
与其花时间折腾伪连接池,不如直击 FPM 下的瓶颈本质:连接创建开销大、空闲连接堆积、慢查询阻塞线程。真正的优化点在这里:
- MySQL 侧调低
wait_timeout到 60–120 秒,防止 PHP 进程崩溃后连接在 DB 侧滞留太久 - 队列任务里禁止循环查
Model::find(),改用Model::whereIn('id', $ids)->get()->keyBy('id')批量加载 - 读写分离时,事务内所有读必须手动指定
DB::connection('write'),别指望配置里的sticky自动路由 - 本地 Docker 环境连不上 Redis/MongoDB?检查
REDIS_HOST或DB_HOST是否填了127.0.0.1——容器里它指向自己,不是宿主机或其它服务
连接池不是开关,是运行模型的产物。FPM 下硬加“池”,只会让你在错误的方向上越调越偏。











