ThinkPHP 不支持数据库连接池，PDO::ATTR_TIMEOUT 仅控制语句执行超时，不控制连接建立超时；需通过 DSN 的 connect_timeout 或 php.ini 的 default_socket_timeout 控制连接超时，并在 initialize 中手动触发连接+try/catch 记录完整上下文。
ThinkPHP 默认不支持数据库连接池，所谓“连接获取超时日志”本质是 PDO 连接建立阶段的超时，不是连接池意义上的等待超时。
为什么 pdo::ATTR_TIMEOUT 在 ThinkPHP 里基本没用
ThinkPHP 的数据库配置中写 'params' => [PDO::ATTR_TIMEOUT => 3] 看似合理，但 PDO 的 ATTR_TIMEOUT 实际只控制 PDO::exec() 和 PDO::query() 等语句执行的等待时间，**不控制 TCP 连接建立或认证阶段的超时**。MySQL 连接卡住（如网络不通、MySQL 拒绝连接、防火墙拦截）时，这个参数完全不生效，PHP 进程会卡在 new PDO() 上，直到系统级 socket 超时（默认常达数分钟）。
- 真正生效的连接超时靠的是 PDO DSN 中的
connect_timeout（MySQLi 支持，PDO MySQL 驱动部分版本才支持） - ThinkPHP 6.x 默认使用
mysqlDSN，需显式改用mysql:host=...;connect_timeout=3 - 若用
pdo_mysql扩展且 PHP 版本 ≥ 8.1，connect_timeout才被识别；低版本只能靠default_socket_timeoutphp.ini 全局设置
如何让连接失败时快速报错并记录上下文
核心思路：把连接建立动作从框架自动触发，改为手动控制 + try/catch + 日志注入。ThinkPHP 的 Db::connect() 是懒加载，首次查询才建连，此时已错过请求上下文捕获时机。
- 在中间件或 Base Controller 的
initialize()中主动调用Db::connect()->getPdo()，包裹 try/catch - 捕获
PDOException后，用Log::record()记录完整信息，包括$e->getMessage()、$e->getCode()、当前 URL、$_SERVER['REQUEST_TIME_FLOAT'] - 特别注意：不要只记
$e->getMessage()，要加$e->getTraceAsString()前几行，否则无法区分是 DNS 解析失败还是密码错误 - 示例关键代码：
try { Db::connect()->getPdo(); } catch (\PDOException $e) { Log::record('DB connect failed: ' . $e->getMessage() . ' | Code: ' . $e->getCode(), 'error'); Log::record('Request URL: ' . request()->url(), 'error'); }
连接池？别被名词带偏，ThinkPHP 当前能做的只有连接复用和故障隔离
所谓“连接池”在 ThinkPHP 生态里不存在官方实现。它的连接管理本质是单例 + 连接复用（同一请求内多次 Db::table() 共享一个 PDO 实例），不是多请求间共享连接队列。
立即学习“PHP免费学习笔记（深入）”；
- 如果你真需要连接等待超时（比如并发高时排队等空闲连接），得自己封装连接管理器，用
Swoole\Coroutine\Channel或Redis做连接令牌分发，但这已脱离 ThinkPHP 原生能力 - 更现实的做法是：用
Db::close()主动释放连接（尤其长流程中非必要时不保持连接），配合 MySQL 的wait_timeout设置防止服务端堆积僵尸连接 - 监控重点应放在
show processlist中的Sleep状态连接数，而不是幻想“连接池等待队列长度”
真正难处理的不是超时本身，而是超时发生时你根本不知道它卡在哪一层——DNS？TCP 握手？SSL 协商？MySQL 认证？这些阶段 ThinkPHP 日志全不覆盖，得靠 strace -p $(pgrep -f 'php.*your_script') 或 MySQL 的 general_log 反向推断。
