thinkphp 不提供数据库连接池，其采用 pdo 或 mysqli 短连接模型，连接等待实为 mysql 层阻塞；监控需从 mysql processlist、php connect() 日志、nginx/apache 队列时间等外围入手，可视化须自行通过 redis 打点实现。
ThinkPHP 没有原生数据库连接池
直接说结论：ThinkPHP（包括 6.x 和 5.1/5.2）本身不提供数据库连接池，更不存在内置的「连接等待队列」或「排队请求可视化」能力。它用的是 PDO 或 mysqli 的短连接模型，每次请求创建、用完即关。所谓“连接池”是常被误传的概念——实际是数据库服务器（如 MySQL）自身的连接管理，TP 只是被动使用 max_connections 限制下的连接资源。
所以你看到的「连接等待」「排队超时」现象，本质是数据库连接耗尽后，TP 在 PDO::__construct 或 mysqli::real_connect 阶段卡住或报错，不是 TP 自己在维护队列。
- 常见错误现象：
SQLSTATE[HY000] [2002] Connection refused或长时间无响应（非超时错误），其实是连接尝试被数据库拒绝或阻塞 - 真实瓶颈通常在 MySQL 的
wait_timeout、max_connections，或 PHP-FPM 子进程并发数与数据库连接数不匹配 - TP 的
database.php中'deploy' => 0（单库）时，所有请求共用同一套连接配置，没有隔离；开启读写分离或分布式部署也不会自动产生“池”
怎么监控连接等待和排队行为
既然 TP 不管队列，就得从外围下手：看数据库是否真在排队、PHP 层是否在等连接、请求是否在应用层堆积。重点不是「TP 怎么可视化」，而是「哪里能抓到排队信号」。
- MySQL 层：执行
SHOW PROCESSLIST，关注Command = Connect且Time持续增长的状态，说明连接建立被阻塞；更准的是查performance_schema.threads和events_waits_summary_global_by_event_name中wait/io/socket/sql/client_connection等待事件 - PHP 层：在
think\db\Connection的connect()方法前后加日志，记录进入时间、PDO 构造耗时、是否抛出PDOException；注意捕获SQLSTATE[HY000] [2002] Connection timed out这类明确的连接超时 - Web 服务器层：Nginx 的
$upstream_queue_time（需开启upstream模块）、Apache 的mod_status，可反映请求在 PHP-FPM 队列中等待的时间，这比“数据库排队”更容易观测且更贴近用户感知
想实现“实时可视化”，绕不开中间件和外部存储
TP 本身不存队列状态，要可视化就必须自己记、自己推、自己查。核心思路是：把“连接申请”当作一个可观测事件，在它发生时打点，而不是等 TP 提供接口。
- 在自定义数据库连接封装类（继承
think\db\Connection）的connect()开头插入逻辑：生成唯一$request_id，写入 Redis 的 Sorted Set，score 为microtime(true)，value 为请求标识（如route+ip） - 连接成功后，用
ZREM清除该条目；失败或超时（比如 >3s）则标记为failed并保留一段时间 - 另起一个轻量 HTTP 接口（如
/api/db-queue-status），调用ZCOUNT统计当前等待数，ZRANGE取最近 10 条，前端轮询即可——不需要 WebSocket 或 SSE - 注意别让监控逻辑拖慢主流程：Redis 写入必须设
timeout=10ms，失败直接忽略，绝不抛异常
容易被忽略的关键点
很多人花半天搭可视化面板，却在基础配置上翻车：
- PHP 的
default_socket_timeout默认是 60 秒，但 MySQL 的connect_timeout是 10 秒——如果 PHP 层没设PDO::ATTR_TIMEOUT，连接卡住会拖满整个请求生命周期，掩盖真实瓶颈 - TP 的
'break_reconnect' => true配置只对查询失败重试有效，对连接建立阶段完全无效；别指望它帮你“跳过排队” - 用 Swoole 或 Hyperf 做长连接时，TP 的 DB 类可能因单例复用导致连接泄漏，此时真正的“连接池”在 Swoole 协程 MySQL 客户端里，TP 只是壳——监控对象得切过去
真正要盯的不是“TP 怎么做连接池”，而是“你的请求在哪个环节卡住”。连不上数据库？先看 MySQL 错误日志里的 Too many connections；请求排队？先看 PHP-FPM 的 slowlog 和 status 页面。可视化只是把已知信号显性化，不是魔法开关。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
