ThinkPHP 不支持真正的数据库连接池，仅通过 PDO 持久连接实现有限复用；需通过 SELECT 1 探测连接健康，并将结果存入 Redis Hash 实现轻量监控与可视化。
ThinkPHP 没有原生数据库连接池
ThinkPHP 的 Db 类和底层 PDO 封装，本质是「按需创建 + 连接复用（PDO::ATTR_PERSISTENT）」，不是连接池。所谓“连接池”在 TP 里是伪概念——它不管理空闲连接数、不自动剔除失效连接、不提供连接借出/归还的生命周期控制。
这意味着：你无法靠配置开启一个真正的连接池，更谈不上对“池中每个连接的健康度”做独立探测和可视化。
- 启用
'persistent' => true只是让 PHP-FPM Worker 复用同一个 PDO 实例，但连接断开后不会自动重连，也不会上报异常 - TP 的
Db::connect()每次调用都可能新建连接（取决于连接参数是否完全一致），没有统一连接容器 - 所有连接状态（如是否超时、是否被服务端 kill）只能在执行 SQL 时暴露，比如抛出
PDOException: SQLSTATE[HY000] [2006] MySQL server has gone away
如何低成本感知连接是否可用
不能依赖“池”，就退一步做连接健康快照：在关键入口（如中间件、定时任务）主动探测当前连接是否可执行简单语句。这不是实时监控，但够用。
推荐用 SELECT 1 配合异常捕获，而不是 PING（MySQLi 支持，PDO 不直接暴露 ping 方法）：
立即学习“PHP免费学习笔记（深入）”；
try {
Db::query('SELECT 1');
return ['status' => 'ok', 'time' => microtime(true)];
} catch (\Throwable $e) {
return ['status' => 'error', 'message' => $e->getMessage()];
}- 不要用
SHOW STATUS或INFORMATION_SCHEMA.PROCESSLIST，权限要求高，且返回的是服务端全局视图，不是当前连接状态 - 避免在每次 HTTP 请求里都执行探测，会拖慢响应；建议放在后台命令（
php think check:db）或 Prometheus Exporter 中定时采集 - 注意 PDO 的
ATTR_ERRMODE必须设为PDO::ERRMODE_EXCEPTION，否则错误静默，探测失效
图形化展示连接状态要绕开 TP 自带日志体系
TP 的 Log 类不记录连接级元数据（如连接 ID、创建时间、最近一次失败时间），没法直接喂给 Grafana 或 ECharts。必须自己埋点。
最轻量做法：把每次探测结果写入 Redis Hash（key = db_health:main），字段包括 last_check、status、latency_ms、error_sample：
Redis::hMset('db_health:main', [
'last_check' => date('c'),
'status' => $result['status'],
'latency_ms' => round(($end - $start) * 1000),
'error_sample' => $result['message'] ?? ''
]);- 前端轮询这个 Hash（通过 ThinkPHP 控制器封装 API），比查 MySQL 表快，也避免日志表膨胀
- 别用
Cache::set()，它的过期策略不可控，且无法原子更新多个字段 - 如果用多组数据库（如读写分离），每个连接名（
config/database.php里的键）对应一个独立 Hash key，方便分开展示
容易被忽略的三个真实坑
真正上线后，以下问题比“怎么画图表”更致命：
- PHP-FPM 子进程复用连接时，
mysqlnd的mysql.ping配置默认关闭，导致连接空闲超时后仍被复用，下一次查询才报错 —— 必须在php.ini加mysqlnd.net_cmd_buffer_size=4096并确认mysqli.reconnect=On - TP 的
Db::close()不会真正关闭底层 PDO，只是清空Db类内部引用；想强制释放，得手动unset($pdo)或等 Worker 重启 - 用 Swoole 或 Hyperf 做常驻内存服务时，TP 的连接管理完全失效，必须改用
swoole_mysql或hyperf/database等原生协程驱动，TP 在这里只是个壳
可视化本身很简单，难的是让每个连接在 PHP 生命周期里行为可预期。别急着画图，先确认你的连接到底在谁手里、什么时候死、死了之后谁负责清理。
