Spring Boot Metrics显示HikariCP连接创建数为1，日志却显示总连接数为2

你好，针对你遇到的这个问题，核心是对HikariCP连接池状态和Spring Boot Metrics指标定义的理解差异，再结合Spring Boot 2.0.2版本的特定实现细节，下面具体拆解：

1. 先明确两个核心概念的差异 #

• HikariCP调试日志中的"总连接数"：这个值对应的是连接池当前的totalConnections，也就是活跃连接+空闲连接的总和。你配置了minimum-idle:2，所以连接池启动后会维护至少2个空闲连接，日志显示总连接数为2是符合预期的（此时没有活跃连接，全部是空闲状态）。
• hikaricp.connections.creation指标：这个指标统计的是从应用启动到现在，连接池主动创建的新连接的累计数量（包括因连接失效、空闲超时重建的连接）。理论上初始化时创建2个连接，这个值应该是2，但你看到的是1，这大概率是版本特定的采集问题。

2. 可能的理解误区与版本问题 #

（1）Metrics采集的版本bug #

Spring Boot 2.0.2对应的Micrometer（Metrics底层实现）版本比较早期，当时的HikariCPMetricsBinder存在一个小缺陷：连接池初始化阶段批量创建的连接，没有被正确统计到connections.creation指标中。只有当后续连接池需要动态补充连接（比如空闲连接低于minimum-idle阈值）时，才会触发该指标的计数。

（2）对指标定义的混淆 #

别把hikaricp.connections.creation和hikaricp.connections.total搞混：

• hikaricp.connections.total才是和日志中"总连接数"对应的指标，你可以检查这个指标的值是否为2，这才是当前池中的真实连接总数。
• connections.creation是累计创建量，比如后续如果某个连接失效被销毁，连接池重建一个新连接，这个指标才会+1。

3. 验证与解决建议 #

• 验证指标对应关系：查看hikaricp.connections.idle指标，正常情况下应该等于2（无业务请求时），hikaricp.connections.total也应该等于2，这两个指标能准确反映当前连接池的状态。
• 测试动态连接创建：发起几个数据库请求，让活跃连接数超过空闲连接数，此时连接池会创建新连接，你会看到hikaricp.connections.creation指标开始增加，这说明指标在动态场景下是正常工作的。
• 版本升级：如果需要准确统计初始化阶段的连接创建量，可以考虑升级Spring Boot到2.1.x及以上版本，后续版本修复了HikariCP Metrics采集的相关问题，能正确统计所有连接创建事件。

内容的提问来源于stack exchange，提问作者Tomoyo Takayama