HikariCP是Java中性能最优、最轻量的数据库连接池，Spring Boot 2.x起默认集成，核心配置需合理设置maximum-pool-size、connection-timeout等参数以避免连接超时或泄漏。
HikariCP 是 Java 中性能最好、最轻量的数据库连接池，Spring Boot 2.x 起已默认集成，无需额外引入依赖（除非你用的是老版本或非 Spring 环境）。配置不难，但关键参数设错容易引发连接超时、连接泄漏、数据库打满等问题。下面直接说清楚怎么配、怎么用、哪些值必须调。
基础配置：5 行代码就能跑起来
如果你用的是 Spring Boot，只需在 application.yml 或 application.properties 里写几项核心配置：
-
spring.datasource.url：JDBC 连接串，例如
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC - spring.datasource.username 和 spring.datasource.password：数据库账号密码
- spring.datasource.hikari.maximum-pool-size：建议设为 10～20（开发环境），生产需按数据库容量调整
- spring.datasource.hikari.minimum-idle：通常设为与 maximum-pool-size 相同，避免动态扩缩带来的抖动
- spring.datasource.hikari.connection-timeout：线上建议 3000（3 秒），防止请求卡死
Spring Boot 会自动创建 HikariDataSource，你通过 @Autowired DataSource 就能注入使用。
手动配置：适合非 Spring 项目或需要精细控制
Java 代码方式更透明，也便于理解底层逻辑：
立即学习“Java免费学习笔记（深入）”；
- 先引入 Maven 依赖（Spring Boot 2.4+ 需显式加 MySQL 驱动）：
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.33</version>
</dependency>
- 再创建 HikariConfig 实例并设置关键参数：
config.setJdbcUrl("jdbc:mysql://localhost:3306/mydb");
config.setUsername("root");
config.setPassword("123456");
config.setDriverClassName("com.mysql.cj.jdbc.Driver");
config.setMaximumPoolSize(15);
config.setMinimumIdle(5);
config.setConnectionTimeout(3000);
config.setIdleTimeout(600000);
config.setMaxLifetime(1800000);
config.setLeakDetectionThreshold(60000); // 检测连接泄漏，单位毫秒
HikariDataSource ds = new HikariDataSource(config);
之后调用 ds.getConnection() 获取连接，用完务必在 finally 或 try-with-resources 中关闭——注意：这里 close() 不是真关连接，而是归还给池。
关键参数怎么设才合理
很多问题出在参数“照抄默认值”上。真实场景中这几个必须校准：
-
maximum-pool-size：不能拍脑袋设 100。先查数据库最大连接数：
SHOW VARIABLES LIKE 'max_connections';，再按公式估算：单实例建议 ≤数据库 max_connections × 0.6 ÷ 应用实例数。比如 MySQL 允许 200 连接、部署 2 台服务，每台设 60 就偏高，40 更稳妥 - connection-timeout 和 validation-timeout 要匹配：后者必须小于前者（推荐 2500ms），否则验证失败后会反复重试，拖慢整体获取速度
- leakDetectionThreshold 建议始终开启（如 60000ms），它能发现忘记 close 的连接，避免池子慢慢“变干”
-
idleTimeout 和 maxLifetime 要满足：idleTimeout 必须小于 maxLifetime，且两者都应略短于数据库的
wait_timeout（MySQL 默认 8 小时），避免连接被数据库主动断开后，池子还不知情
常见踩坑点提醒
这些错误高频出现，但修复成本很低：
- Spring Boot 2.4+ 启动报
ClassNotFoundException: com.mysql.cj.jdbc.Driver？→ 显式配置spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver - 频繁报
Connection is not available, request timed out？→ 先看是否maximum-pool-size设太小，再检查数据库连接数是否被打满（show processlist） - 连接池里空闲连接越来越少，最后拿不到连接？→ 开启
leakDetectionThreshold，再排查业务代码有没有漏掉 close 或没走 try-with-resources - 用虚拟线程（Spring Boot 3.2+）后响应变慢甚至超时？→ 别沿用传统“线程数 : 连接数 = 10:1”的经验，虚拟线程并发暴涨，连接池上限反而成了瓶颈，要适当提高
maximum-pool-size并加强监控
