一文搞懂 Spring Boot 默认数据库连接池 HikariCP

一、为什么要用数据库连接池？

每次访问数据库，如果都经历：

创建 TCP 连接
MySQL 身份验证
执行 SQL
关闭连接

这些操作非常耗时，在并发场景下会严重拖慢系统性能。

👉 数据库连接池的作用就是：

预先创建好一定数量的数据库连接
请求来了直接复用
用完放回池中
避免频繁创建 / 销毁连接

二、什么是 HikariCP？

HikariCP 是一个高性能 JDBC 连接池实现，也是：

✅ Spring Boot 官方默认连接池
✅ 目前主流连接池中性能最优
✅ 设计目标：快、轻量、简单

Spring Boot 3.x 中，哪怕你什么都不配置，底层默认用的就是它。

三、典型 Hikari 配置示例

yaml 复制代码

spring:
  datasource:
    hikari:
      connection-test-query: SELECT 1
      connection-timeout: 60000
      idle-timeout: 500000
      max-lifetime: 540000
      maximum-pool-size: 10
      minimum-idle: 5
      pool-name: AiReportHikariPool

AI写代码yaml
12345678910

下面我们逐个参数拆开讲。

四、Hikari 核心参数详解

1️⃣ connection-test-query

makefile 复制代码

connection-test-query: SELECT 1

AI写代码yaml
1

作用：

用于检测数据库连接是否可用

是否必须？

❌ 大多数情况下不需要
Hikari 默认使用 JDBC4 的 isValid() 方法，性能更好

建议：

bash 复制代码

# MySQL / PostgreSQL 可直接删除
# connection-test-query: SELECT 1

AI写代码yaml
12

2️⃣ connection-timeout（非常重要）

makefile 复制代码

connection-timeout: 60000

AI写代码yaml
1

作用：

从连接池获取连接时，最多等待多久
超过时间直接抛异常

风险：

时间过长（60 秒）会导致线程长时间阻塞
在高并发下可能拖垮整个服务

推荐值：

makefile 复制代码

connection-timeout: 30000

AI写代码yaml
1

3️⃣ idle-timeout

makefile 复制代码

idle-timeout: 500000

AI写代码yaml
1

作用：

空闲连接在池中能存活的最长时间
超时后会被回收

建议：

yaml 复制代码

idle-timeout: 300000  # 5 分钟

AI写代码yaml
1

4️⃣ max-lifetime（非常重要）

arduino 复制代码

max-lifetime: 540000

AI写代码yaml
1

作用：

一个连接在池中的最大生命周期
到期后强制销毁并重建

为什么需要？

防止数据库（如 MySQL）主动断开"老连接"

重要规则：

arduino 复制代码

max-lifetime > idle-timeout

AI写代码text
1

推荐值：

python 复制代码

max-lifetime: 1800000  # 30 分钟

AI写代码yaml
1

5️⃣ maximum-pool-size

arduino 复制代码

maximum-pool-size: 10

AI写代码yaml
1

作用：

连接池允许的最大连接数

经验值：

场景	推荐
单体应用	10--20
微服务	5--15
高并发	需压测

❗ 并不是越大越好，数据库本身也有连接上限

6️⃣ minimum-idle

makefile 复制代码

minimum-idle: 5

AI写代码yaml
1

作用：

保持的最小空闲连接数

建议：

一般设置为 maximum-pool-size 的一半左右
不要和最大连接数相同，否则连接永不释放

7️⃣ pool-name

makefile 复制代码

pool-name: AiReportHikariPool

AI写代码yaml
1

作用：

连接池名称
仅用于日志和监控识别

建议：

给每个服务一个有意义的名字，方便排查问题

五、常见错误配置总结

❌ 连接生命周期太短

❌ connection-timeout 设太大

❌ max-lifetime 小于 idle-timeout

❌ 盲目把 pool-size 调很大

这些都会导致：

连接频繁重建
吞吐下降
数据库压力异常

六、推荐的「稳定生产配置」

yaml 复制代码

spring:
  datasource:
    hikari:
      connection-timeout: 30000
      idle-timeout: 300000
      max-lifetime: 1800000
      maximum-pool-size: 10
      minimum-idle: 5
      pool-name: AiReportHikariPool

AI写代码yaml
123456789

👉 适合 90% 中小型 Spring Boot 项目

七、总结

HikariCP 的核心思想不是"多"和"复杂"，
而是"刚刚好"和"足够快"。