laravel本身不提供数据库连接池，仅在swoole/roadrunner/octane等常驻内存环境中才支持真正连接池；php-fpm下所谓“长连接”实为进程级复用，开启pdo::attr_persistent易致事务污染；mongodb驱动是唯一原生支持连接池的场景。
Laravel 本身不管理长连接，所谓“长连接资源管理”其实是对运行环境、PDO 行为和数据库服务端三者协同的控制。FPM 下没有真正长连接，Swoole 下才有可配置的连接池；盲目开启 PDO::ATTR_PERSISTENT 反而容易引发事务污染和连接泄漏。
PHP-FPM 环境下：别信“长连接”，只做连接复用控制
在 FPM 中，每个 worker 进程生命周期内可复用 PDO 连接，但请求一结束连接就释放（除非开了持久连接）。这不是连接池，只是进程级复用。
- 确认
'options' => [PDO::ATTR_PERSISTENT => false]—— 默认就是 false，但有人手动设 true 后导致事务残留、临时表冲突 - 不要在循环里反复调用
DB::connection()，先存到变量里复用：$db = DB::connection(); $db->table(...)->get(); $db->table(...)->insert(); - 检查
mysql.allow_persistent是否为 Off（php.ini），避免底层 MySQLi 暗中启用持久连接 - FPM worker 数 × 平均每请求连接数 = 实际并发连接峰值，压测前务必算清：比如 20 个 worker × 3 个活跃连接 = 60，要小于 MySQL 的
max_connections
Swoole/Octane 环境下：pool 配置才真正生效
config/database.php 里的 'pool' 键只在 Swoole 或 Octane 场景下被读取并用于初始化协程连接池。FPM 下写它等于没写。
- 确保使用
swooletw/laravel-swoole或laravel/octane，且启动命令不是php artisan serve或 Nginx + FPM - MySQL 配置块中必须加：
'pool' => ['max_connections' => 20, 'min_connections' => 5]，不能只写'pool' => true - host 必须是 IP（如
127.0.0.1），不能是localhost，否则 Swoole 会走 Unix socket，绕过连接池逻辑 - 配合
'options' => [PDO::ATTR_TIMEOUT => 5]，防止慢查询卡住整个池子
MongoDB 场景：唯一原生支持连接池的 Laravel 官方驱动
Laravel-MongoDB（基于官方 PHP 扩展）的连接池由 C driver 层实现，maxPoolSize 和 minPoolSize 是真实生效的参数，不是占位符。
- 在
config/database.php的mongodb连接块中配置：'options' => ['maxPoolSize' => 20, 'minPoolSize' => 5, 'connectTimeoutMS' => 10000] - 必须启用
'persistConnection' => true，否则每次请求仍重建连接+认证 -
maxIdleTimeMS建议设为300000（5 分钟），避免空闲连接长期滞留失效 - 注意：该配置对 MySQL/PostgreSQL 驱动完全无效，仅 MongoDB 支持
连接泄漏最常发生的三个地方
长连接资源耗尽，90% 不是因为没配池，而是连接没及时释放或被意外持有。
- 队列任务中未显式关闭连接：长时间运行的 Job 里执行完 DB 操作后，建议手动
DB::purge('mysql')（仅限 Swoole/Octane），FPM 下无效 - WebSocket 或定时任务里用了
DB::connection()->reconnect()却没处理好上下文，导致新连接建了但旧连接没关 - 自定义 Artisan 命令中启用了事务但没 commit/rollback，连接一直被占着直到脚本退出
真正难的不是配参数，而是分清当前运行环境——FPM 就老老实实控并发、设超时、压测调参；Swoole 才谈连接池；MongoDB 是个例外，能直接配。混淆这三者，所有配置都会失效。
