Laravel如何做数据库连接池_Laravel高并发连接优化方案【详解】-Laravel-PHP中文网

Laravel默认无数据库连接池，因PHP-FPM无状态特性无法跨请求复用连接；仅在Swoole等常驻进程环境中可通过协程实现真正连接池。

laravel如何做数据库连接池_laravel高并发连接优化方案【详解】

为什么 Laravel 默认没有数据库连接池

Laravel 底层用的是 PDO，而 PDO 本身不维护连接池——每次 DB::connection() 或模型查询，都可能新建或复用一个 PHP-FPM 进程内的 PDO 实例，但这个“复用”仅限于当前请求生命周期。PHP 的无状态特性决定了它无法跨请求共享数据库连接，所以严格来说，Laravel 没有、也不可能原生实现传统意义上的连接池（如 Go 的 database/sql 或 Java 的 HikariCP）。

常见错误现象：SQLSTATE[HY000] [1040] Too many connections，尤其在压测或队列集中消费时爆发，不是因为 Laravel “没配好”，而是 MySQL 的 max_connections 被瞬时打满，根源在于短连接高频创建 + FPM 子进程数配置过高 + 查询未及时释放。

不要试图用 DB::reconnect() 或手动 DB::disconnect() 来“模拟池化”——它解决不了连接数上限问题
连接复用只发生在单次请求内，DB::table('users')->first() 和后续同连接的 ->where(...)->get() 共享同一个 PDO 实例，但下个请求必然重连
如果你用的是 Swoole 或 RoadRunner 这类常驻内存服务器，才真正具备实现连接池的基础；否则所有“Laravel 连接池扩展”本质只是连接缓存或连接代理，不改变 MySQL 侧连接计数逻辑

高并发下真正有效的三板斧

与其纠结“怎么加连接池”，不如直面 Laravel 在 FPM 场景下的实际瓶颈：连接创建开销、空闲连接堆积、慢查询拖垮整体。

调低 MySQL 的 wait_timeout（建议 60–120 秒），避免 PHP 进程崩溃后连接在 MySQL 侧长期滞留
在 config/database.php 的 MySQL 配置里加上 'options' => [PDO::ATTR_TIMEOUT => 5]，防止个别查询卡死导致连接被占住
强制使用连接读写分离时，确保 read 和 write 都配置了 sticky 为 true，否则事务中后续读可能落到从库，引发数据不一致
队列任务里避免在循环中反复调用 Model::find() —— 改用 Model::whereIn('id', $ids)->get()->keyBy('id') 批量查，减少连接往返次数

Swoole 场景下可用的连接池方案（仅限常驻进程）

只有当你已切换到 Swoole HTTP Server 或使用 swooletw/laravel-swoole 时，“连接池”才有落地意义。此时每个 Worker 进程可持有一组长连接，由协程调度复用。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

示例关键配置（config/database.php）：

'mysql' => [
    'driver' => 'mysql',
    'url' => env('DATABASE_URL'),
    'host' => env('DB_HOST', '127.0.0.1'),
    // 注意：这里不能写 localhost，Swoole 下会走 socket 导致连接失败
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'prefix_indexes' => true,
    'strict' => true,
    'engine' => null,
    'options' => extension_loaded('pdo_mysql') ? array_filter([
        PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
        PDO::MYSQL_ATTR_SSL_CERT => env('MYSQL_ATTR_SSL_CERT'),
        PDO::MYSQL_ATTR_SSL_KEY => env('MYSQL_ATTR_SSL_KEY'),
    ]) : [],
    // 关键：启用 Swoole 协程 MySQL 连接池（需安装 ext-swoole）
    'pool' => [
        'min_connections' => 1,
        'max_connections' => 32,
        'connect_timeout' => 10.0,
        'wait_timeout' => 3.0,
        'heartbeat' => -1,
    ],
],

必须配合 swooletw/laravel-swoole v3+ 或自研协程适配层，原生 Laravel 不识别 pool 配置项
max_connections 不宜设过高——每个 Worker 独立维护一份池，总连接数 = Worker 数 × max_connections，仍可能冲垮 MySQL
务必关闭 DB::listen() 日志监听，协程环境下它会导致上下文错乱和内存泄漏