真正要防的是短生命周期对象意外延长数据库连接占用时间;db::connection()虽自动释放,但事务中混入网络i/o、懒加载或artisan命令未复用连接会导致连接堆积、锁表或超时。

短生命周期对象(如 HTTP 请求中的 Eloquent 模型、DB 连接)无法也不应持有长连接;真正要防的是它们意外延长数据库连接占用时间,导致锁表、连接数打满或事务卡住。
为什么 DB::connection() 在请求结束时自动释放,但你仍会遇到连接堆积
PHP-FPM 每个 worker 处理完请求后,PDO 实例会被销毁,但若你在请求中做了以下操作,连接实际“滞留”时间远超逻辑所需:
- 在事务中调用
Http::post()或GuzzleHttp\Client—— 事务未提交,连接一直持有着行锁,同时空等网络 I/O - 用
Product::lockForUpdate()->find($id)触发懒加载或访问器,导致额外查询延后执行,锁持有时间不可控 - 在 Artisan 命令中未显式断开(比如长循环里反复
DB::connection()而不复用),每个迭代都新建连接
根本问题不是“对象生命周期短”,而是“本该快速结束的 DB 操作被拖长”。
DB::transaction() 内禁止任何网络 I/O 的硬性规则
事务块必须是纯数据库操作。远程请求移出事务不是优化建议,而是强制要求 —— 否则你会看到 SQLSTATE[HY000] [1205] Deadlock found 或 Lock wait timeout exceeded。
- ✅ 正确:先
DB::transaction(fn () => $order->save()),再Http::post('https://pay.example.com', [...]) - ❌ 错误:在闭包里写
Http::get(...); $order->save();—— 连接卡住,锁不释放 - ⚠️ 补偿要点:远程调用失败时,不能靠事务回滚兜底,得用
dispatchNow(new HandlePaymentFailureJob($order))单独处理
Artisan 命令中手动管理连接复用的实操方式
命令行任务(如队列消费者、轮询脚本)默认无请求上下文,DB::connection() 每次调用都可能新建 PDO 实例。需主动复用:
- 在
handle()开头获取一次连接:$connection = DB::connection(); - 后续所有查询统一走
$connection->table(...)或$connection->select(...),避免反复调用DB::connection() - 若需切换连接(如读写分离),用
DB::connection('write')显式指定,并复用该实例 - 不推荐
PDO::ATTR_PERSISTENT:FPM 下易状态污染,命令行下反而可能因进程常驻导致连接泄漏
验证是否复用成功:dd(spl_object_id($connection->getPdo()), spl_object_id(DB::connection()->getPdo())) —— 两个 ID 应一致。
真正需要连接池?先确认你不在 PHP-FPM 环境下
Laravel 本身没有、也无法实现跨请求连接池。所谓“配置连接池”,本质是换运行环境:
- 还在用
php-fpm?别折腾pool配置项 —— 它在 FPM 下无效,max_connections参数会被忽略 - 已切到
Swoole?启用swooletw/laravel-swoole并在config/database.php中加'pool' => true才有意义 - 用
ProxySQL?改.env里的DB_HOST和DB_PORT即可,它完全独立于 Laravel 连接逻辑
最容易被忽略的一点:MySQL 侧的 wait_timeout(默认 28800 秒)和 Laravel 的连接超时无关,但它决定了空闲连接在数据库端挂多久才被杀掉 —— 生产环境建议设为 60–120,配合应用层快速释放。











