如何设置ThinkPHP数据库连接池最大等待数及防雪崩排队请求配置？

本文共计1069个文字，预计阅读时间需要5分钟。

ThinkPHP+6 默认不内置数据库连接池，所谓的最大等待数实际上是指底层使用 PDO 连接池（如 Swoole 协程环境下的 Swoole + ThinkPHP-Swoole 扩展等）的配置项。TP 本身只管理 think\db\Connection 的连接复用和释放逻辑。您看到的排队超时和等待连接现象，往往是来自协程环境对底层连接池的错误使用或未显式配置。

实操建议：

• 确认是否真在协程模式运行：检查是否启用了 think-swoole 或自定义协程 Server，非协程环境（FPM）压根没有连接池概念，max_wait_time 配置无效
• 连接池配置不在 database.php，而在 config/swoole.php 或启动脚本中 —— 例如 Swoole MySQL 连接池需单独 new Swoole\Coroutine\MySQL\Pool 并传入 max_idle_time、max_active、max_wait_time
• ThinkPHP 官方 think-swoole 扩展目前（v4.x）仅支持连接复用，不接管底层连接池参数；若要用 max_wait_time，得绕过 TP DB 类，直接操作 Swoole 原生 Pool 实例

为什么改了 max_wait_time 没反应？

常见错误是把配置写在了错误位置，或没触发协程上下文。