ThinkPHP数据库配置避坑：解决数据库连接池耗尽与超时重连【解答】-ThinkPHP-PHP中文网

thinkphp高并发下“mysql server has gone away”报错本质是连接池未启用或配置失效、持久连接导致句柄复用断连、空闲连接超时被mysql主动关闭、事务未正确回滚占用连接。需确认启用pool配置、禁用pdo持久化、合理设置max_active/min_idle/max_wait_time，并在cli/swoole中加心跳保活，事务必须显式提交或回滚。

thinkphp数据库配置避坑：解决数据库连接池耗尽与超时重连【解答】

ThinkPHP项目在高并发或长任务场景下频繁出现“SQLSTATE[HY000]: General error: 2006 MySQL server has gone away”或“Wait timeout for connection”报错，本质是连接池配置与运行时行为不匹配导致的资源耗尽或连接失效未恢复。

确认是否真启用了连接池

打开 config/database.php，找到对应数据库配置（如 'mysql'），检查是否存在 'pool' => [...] 子数组。若只有 'max_active'、'min_idle' 等字段但未包裹在 'pool' 键下，该配置完全无效——ThinkPHP 6.1+ 才原生识别 pool 配置项，TP5.1 及更早版本写进去也白搭。

执行 php think run 查看启动日志，搜索 "ConnectionPool" 字样；若无输出，说明连接池未激活，所有 pool 相关参数（包括 wait_timeout、max_idle_time）均不生效。

【必须确保 'pool' => ['enable' => true] 显式存在且值为 true】

禁用持久连接，避免复用已断开句柄

在数据库配置的 'params' 数组中，强制添加 PDO::ATTR_PERSISTENT => false。

不要被 'persistent' => true 的命名误导：它只是透传给 PDO 的持久化标记，依赖 PHP-FPM 进程生命周期，一旦 MySQL 重启或网络闪断，该连接将永久卡死，后续请求全部失败。FPM 动态模式下 worker 频繁启停，此选项基本无效，反而加剧连接泄漏。

这一步操作起来很简单，直接在 config/database.php 的 mysql 连接配置里补上即可：

'params' => [
PDO::ATTR_PERSISTENT => false,
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
]

设置连接池核心闸门参数

第一步：设 max_active 为硬性上限。例如业务峰值并发约 80，MySQL max_connections 设为 200，则此处建议设为 15～20。超过该数的新请求将排队或熔断，而非无节制创建新连接打爆数据库。

第二步：设 min_idle 为 0 或极小值（如 2）。预热连接看似提升首请求性能，但在 wait_timeout 较短（如云 RDS 设为 300 秒）时，预建连接极易在空闲中被 MySQL 主动断开，变成一堆“僵尸连接”，占用池位却不干活。

第三步：设 max_wait_time 为 3000（毫秒）。这是获取连接的排队超时阈值，不是 SQL 执行超时。设太小（如 100）会导致高并发下大量 WaitTimeoutException；设太大（如 30000）会让用户干等半分钟才报错，体验极差。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

注意：idle_timeout 在 TP6.1 中实际未生效，别依赖它自动清理空闲连接。

CLI 和 Swoole 场景必须手动保活

方法一：命令行任务开头加心跳探测

在命令入口文件顶部插入以下代码：

$connection = Db::getConnection();
try {
  $connection->getPdo()->exec('SELECT 1');
} catch (\PDOException $e) {
  if (strpos($e->getMessage(), 'MySQL server has gone away') !== false) {
    Db::close();
    Db::connect();
  }
}

方法二：Swoole Worker 启动时初始化 + 定时探活

监听 onWorkerStart 事件，在内部调用 Db::connect() 初始化连接；再用 Timer::tick(3000, function () { ... }) 每 3 秒执行一次 SELECT 1 探测，失败则 Db::close() + Db::connect()。

【切勿在事务中做此探测，否则破坏事务一致性】