HikariCP 是 Java 中性能最佳、最轻量的 JDBC 连接池，需合理配置核心参数并规范使用。推荐通过 HikariConfig 初始化，关键参数包括 maximumPoolSize、minimumIdle、connectionTimeout、idleTimeout 和 maxLifetime；必须用 try-with-resources 确保连接归还；支持 JMX 与 API 监控。
HikariCP 是目前 Java 生态中性能最好、最轻量的 JDBC 连接池，配置简单但关键参数需合理设置才能发挥其优势。它默认已做大量优化，多数场景下只需少量配置即可稳定高效运行。
基础依赖与初始化
先在项目中引入 HikariCP（Maven）：
<dependency>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
<version>5.0.1</version>
</dependency>
创建连接池实例时推荐使用 HikariConfig 构建，便于集中管理配置：
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/mydb");
config.setUsername("user");
config.setPassword("pass");
config.setDriverClassName("com.mysql.cj.jdbc.Driver");
HikariDataSource dataSource = new HikariDataSource(config);
核心参数调优建议
以下参数影响连接池稳定性与响应能力，应根据实际数据库负载和应用并发调整：
立即学习“Java免费学习笔记（深入）”；
- maximumPoolSize：默认 10，建议设为数据库允许的最大连接数 × 0.8 左右；高并发服务可设为 20–50，避免打满 DB
- minimumIdle：默认等于 maximumPoolSize，生产环境可略低（如设为 5–10），节省空闲连接资源
- connectionTimeout：获取连接超时时间，默认 30 秒；建议设为 1–5 秒，避免线程长时间阻塞
- idleTimeout：空闲连接最大存活时间，默认 10 分钟；若数据库主动断连（如 MySQL wait_timeout=300），应设为略小于该值（如 280000 毫秒）
- maxLifetime：连接最大生命周期，默认 30 分钟；建议比数据库 wait_timeout 小 1–2 分钟，防止被服务端强制关闭
连接使用与释放规范
HikariCP 本身不管理事务，连接用完必须显式关闭（归还到池中），否则造成连接泄漏：
try (Connection conn = dataSource.getConnection();
PreparedStatement stmt = conn.prepareStatement("SELECT * FROM user")) {
ResultSet rs = stmt.executeQuery();
// 处理结果
} catch (SQLException e) {
// 异常处理
}
务必使用 try-with-resources，确保 close() 被调用。手动调用 conn.close() 也可，但容易遗漏。
监控与问题排查
HikariCP 提供 JMX 和 API 接口查看运行状态：
- 启用 JMX：设置 config.setRegisterMbeans(true)，通过 JConsole 查看活跃/空闲连接数、等待线程数等
- 代码中检查：调用 dataSource.getHikariPoolMXBean().getActiveConnections() 获取实时指标
- 常见问题：若出现大量线程卡在 getConnection()，优先检查 connectionTimeout、数据库是否宕机、网络是否异常或最大连接数是否被占满
