ThinkPHP 6 本身不提供数据库连接池配置，“最大等待数”需在协程环境（如 Swoole）中通过底层连接池（如 Swoole\Coroutine\MySQL\Pool）的 max_wait_time 参数设置，且仅在启用协程、正确集成原生池时生效。
ThinkPHP 6 连接池最大等待数在哪配？
ThinkPHP 6 默认不内置数据库连接池，所谓“最大等待数”其实是底层 PDO 连接池（如 Swoole 协程 MySQL 或 Hyperf 的 pool）的配置项，TP 自身只管 think\db\Connection 的连接复用和释放逻辑。你看到的“排队超时”“等待连接”现象，往往来自协程环境（如 Swoole + ThinkPHP-Swoole 扩展）下对底层连接池的误用或未显式配置。
实操建议：
- 确认是否真在协程模式运行：检查是否启用了
think-swoole或自定义协程 Server，非协程环境（FPM）压根没有连接池概念，max_wait_time配置无效 - 连接池配置不在
database.php，而在config/swoole.php或启动脚本中 —— 例如 Swoole MySQL 连接池需单独 newSwoole\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 没反应？
常见错误是把配置写在了错误位置，或没触发协程上下文。比如在 FPM 下给 mysql.pool.max_wait_time = 3000 赋值，这个值根本不会被读取 —— 因为 FPM 不创建协程池实例。
典型失效场景：
立即学习“PHP免费学习笔记（深入）”；
- 用
php think swoole启动但未启用--enable-coroutine（旧版）或未在swoole.php中开启'enable_coroutine' => true - 在控制器里用
Db::table()->select()，但底层仍走的是同步 PDO，未切换到协程 MySQL 客户端 - 使用了
think-swoole的Db代理，但它默认不启用连接池，只做协程化封装；真正池行为需手动集成swoole/mysql或hyperf/database类库
防雪崩：请求排队不是靠调大 max_wait_time
把 max_wait_time 从 1000 改成 5000 毫秒，并不能防雪崩，反而会让失败更慢、线程/协程卡得更久。雪崩本质是下游（DB）响应变慢 → 上游（PHP）连接堆积 → 新请求持续排队 → 最终超时雪崩。
真正该做的：
- 设置合理熔断阈值：用
Hyperf\CircuitBreaker或自定义中间件，在 DB 查询耗时 > 800ms 且连续 5 次失败后，自动降级返回缓存或空数据 - 限制并发请求数：在入口层（如 Nginx limit_req 或 Swoole 的
max_request）控制单 worker 并发，比依赖连接池等待更可控 - 区分读写流量：写操作走主库并设短超时（
timeout=3），读操作走从库+长连接+预热，避免写阻塞读
ThinkPHP-Swoole 下怎么测连接池是否生效？
最直接的办法是看日志和连接数变化。Swoole 连接池本身不暴露监控接口，但你可以通过几个信号判断：
- 开
'debug' => true后，观察日志中是否出现[swoole] mysql pool created with max_size=20类提示（需自行 patch 日志输出） - 用
ss -tnp | grep :3306 | wc -l对比 FPM 和 Swoole 模式下 ESTABLISHED 连接数 —— 若 Swoole 下稳定在 20 左右（而非随 QPS 线性上涨），说明池复用成功 - 故意让一个查询 sleep(5)，再并发 30 个请求；若前 20 个快速返回、后 10 个等满
max_wait_time后报Wait timeout for connection from pool，就证明池行为已生效
复杂点在于：ThinkPHP 的 Db 类和原生 Swoole MySQL Pool 是两套生命周期管理，混用容易导致连接泄漏或 wait forever。别指望一个 config 项能兜底，得清楚自己到底在用哪一层的连接控制。
