获取Nacos连接池连接数需先确认SDK类型及版本，HTTP模式下通过Hyperf的guzzle或http_client连接池调用getStats()获取活跃连接数，gRPC模式则依赖对应客户端自身管理。
Hyperf 本身不直接管理 Nacos 客户端的连接池（如 HTTP 连接池或 gRPC 连接池），而是依赖所集成的 Nacos SDK（如 hyperf/nacos 组件底层使用的 nacos-php/nacos-sdk-php 或其 fork 版本）。因此，**获取 Nacos 连接池连接数的关键在于：确认你用的是哪个 Nacos SDK、它是否暴露了连接池监控接口、以及是否启用了对应客户端（HTTP/gRPC）的连接池配置。**
确认当前使用的 Nacos SDK 类型和版本
Hyperf 的 hyperf/nacos 组件在 v3.x 中默认使用基于 Guzzle HTTP 客户端的实现（即走 HTTP 协议），连接池由 Guzzle 管理；若你手动替换成 gRPC 客户端（如通过 nacos-php/nacos-sdk-php-grpc），则连接池由 Swoole/协程 HTTP 客户端或 gRPC 扩展自身控制。
- 运行
composer show nacos-php/nacos-sdk-php或查看composer.lock确认 SDK 版本 - v2.x SDK（旧版）通常无连接池统计能力；v3.x+（如
nacos-php/nacos-sdk-php≥3.0.0）开始支持协程 HTTP 客户端及可配置连接池 - 检查
config/autoload/nacos.php中是否配置了'http' => ['pool' => [...]]
从 Guzzle 连接池中获取活跃连接数（HTTP 模式）
若使用默认 Guzzle HTTP 客户端（Hyperf v3 默认），Guzzle 的 Pool 本身不直接暴露“当前活跃连接数”，但可通过其底层 Handler（如 SwooleHandler 或 CurlMultiHandler）间接观察。更实用的方式是：启用 Hyperf 的 guzzle 组件连接池监控（需配合 hyperf/pool）。
- 确保
config/autoload/guzzle.php中启用了连接池，例如：
'pool' => [
'min_connections' => 1,
'max_connections' => 32,
'connect_timeout' => 5.0,
'wait_timeout' => 3.0,
'heartbeat' => -1,
],
- 在代码中通过
Hyperf\Pool\PoolFactory获取该池实例并调用getStats()：
$pool = $this->container->get(PoolFactory::class)->get('guzzle');
$stats = $pool->getStats(); // 返回数组：['active' => 5, 'idle' => 3, 'waiting' => 0]
注意：guzzle 连接池名默认为 'guzzle'，且仅当你的 Nacos 客户端真正复用了该池（即通过 GuzzleHttp\Client 实例构建）时才有效。
监听 Nacos SDK 内部 HTTP 客户端（推荐方式）
新版 nacos-php/nacos-sdk-php（≥3.1.0）已将 HTTP 客户端抽象为 Nacos\Contract\HttpClientInterface，并支持注入自定义协程客户端（如 Hyperf\HttpClient\CoroutineHttpClient）。此时连接池实际由 hyperf/http-client 管理。
- 检查
config/autoload/nacos.php是否配置了'http_client' => 'coroutine' - 获取
Hyperf\HttpClient\Pool\PoolFactory对应的http_client池：
$pool = $this->container->get(PoolFactory::class)->get('http_client');
$stats = $pool->getStats();
该 $stats 即为当前 Nacos 请求所用 HTTP 客户端的真实连接池状态。
日志与调试辅助验证
若无法直接读取连接数，可通过开启 DEBUG 日志观察连接复用行为：
- 在
config/autoload/logger.php中为'nacos'channel 启用DEBUG级别 - 在 Nacos SDK 源码中（如
Nacos\Http\GuzzleHttpClient）临时加日志，打印$client->getConfig('handler')->__debugInfo() - 使用
swoole_table或 Prometheus +hyperf/metric自定义采集连接池指标（适合生产监控）
不复杂但容易忽略。
