Laravel本身不支持数据库连接池,因PHP-FPM无状态进程模型无法跨请求复用连接;仅在Swoole/RoadRunner/Octane等常驻内存环境中,通过协程调度才能实现真正连接池,且需MySQL侧配合调优。

config/database.php,只要跑在 PHP-FPM 下,就不可能有真正意义上的连接池——这是由 PHP 的无状态进程模型决定的。只有切换到 Swoole(或 RoadRunner、Octane)这类常驻内存运行环境后,“连接池”才具备落地前提。
为什么 config/database.php 里加 'pool' => true 没用
这不是你配错了,是 Laravel 框架压根没读取这个字段。翻源码可见:vendor/laravel/framework/src/Illuminate/Database/DatabaseManager.php 中搜索 pool,结果为零;sticky 也仅出现在注释和测试里,生产逻辑中完全未参与连接管理。所谓“连接复用”,仅限单次请求内:同一个 DB::connection() 实例多次查询会共用一个 PDO 对象,但请求一结束,连接就关闭(除非开了 PDO::ATTR_PERSISTENT,但那不是池,是持久连接,副作用严重)。
Swoole 环境下必须显式启用协程连接池
当你已使用 swooletw/laravel-swoole 或 laravel/octane 启动应用时,每个 Worker 进程可长期存活,此时才能靠协程调度复用一组长连接。关键配置点如下:
-
host必须写成 IP(如127.0.0.1),不能写localhost,否则 Swoole 会走 Unix socket,连接池失效 - 在
config/database.php的 MySQL 连接块中加入:'options' => [PDO::ATTR_TIMEOUT => 5],防止慢查询卡死连接 - 读写分离场景下,
read和write都要配置'sticky' => true,否则事务中后续读可能落到从库,引发数据不一致 - 若用
octane,需确认启动命令含--server=swoole或--server=roadrunner,且config/octane.php中启用了数据库连接复用相关钩子
MySQL 侧必须配合调优,否则连接池形同虚设
连接池再好,也得 MySQL 接得住。常见坑是连接数瞬间打满,报错 SQLSTATE[HY000] [1040] Too many connections,根源不在 Laravel,而在 MySQL 配置与 PHP 行为不匹配:
- 把
wait_timeout从默认 28800(8 小时)降到60–120秒,避免 PHP 进程崩溃后连接在 MySQL 侧长期滞留 - 确认
max_connections设置合理:建议为(worker 数 × pool_size) + 20%冗余,例如 8 个 Swoole worker × 每个池 10 连接 = 80,那就设max_connections = 100 - 禁用
skip-name-resolve,防止 DNS 反查拖慢连接建立 - 不要在队列任务循环里反复调用
User::find($id),改用User::whereIn('id', $ids)->get()->keyBy('id')批量查,减少连接往返次数
wait_timeout 和 PHP 进程异常退出后的连接残留,这两点不处理,池再大也撑不过一次压测。


















