配置 hikaricp 的核心是实例化 hikariconfig 对象并设置关键属性，如 jdbc url、用户名、密码以及连接池大小，随后将其传入 hikaridatasource 构造函数即可创建数据源。通常建议通过代码显式配置而非依赖默认值，特别是 maximumpoolsize 和 connectiontimeout，以确保应用在高负载下的稳定性。若使用 spring boot，则只需在 application.yml 或 properties 文件中定义 spring.datasource.hikari.* 相关属性，框架会自动完成装配。
如何通过 Java 代码手动配置 HikariCP？
手动配置需要创建一个 HikariConfig 实例，调用其 setter 方法设置各项参数，最后用该配置对象初始化 HikariDataSource。这种方式适合非 Spring 环境或需要动态调整连接池参数的场景。必须确保在应用关闭时调用 close() 方法释放资源。
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
public class ManualHikariConfig {
public static void main(String[] args) {
// 1. 创建配置对象
HikariConfig config = new HikariConfig();
// 2. 设置基本连接信息
config.setJdbcUrl("jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC");
config.setUsername("root");
config.setPassword("password");
// 3. 设置连接池参数
config.setMaximumPoolSize(10); // 最大连接数
config.setMinimumIdle(5); // 最小空闲连接数
config.setConnectionTimeout(30000); // 获取连接超时时间 (毫秒)
config.setIdleTimeout(600000); // 空闲连接存活最大时间 (毫秒)
config.setMaxLifetime(1800000); // 连接最大存活时间 (毫秒)
config.setDriverClassName("com.mysql.cj.jdbc.Driver");
// 4. 创建数据源
HikariDataSource dataSource = new HikariDataSource(config);
try {
// 测试获取连接
System.out.println("Connection acquired: " + dataSource.getConnection());
} catch (Exception e) {
e.printStackTrace();
} finally {
// 5. 关闭数据源以释放资源
dataSource.close();
}
}
}
上述代码展示了完整的配置流程。注意 setMaximumPoolSize 不应设置得过大，否则会导致数据库连接耗尽；setConnectionTimeout 决定了当所有连接都在使用时，新请求等待多久后抛出异常。这些参数直接影响系统的并发能力和响应速度。
立即学习“Java免费学习笔记（深入）”；
Spring Boot 中如何自动配置 HikariCP？
在 Spring Boot 项目中，无需编写任何 Java 配置类，只需在 application.yml 中提供标准的 spring.datasource 配置，并添加 hikari 子节点覆盖默认值即可。Spring Boot 的自动配置机制会检测 Classpath 下是否存在 HikariCP，并自动注册 HikariDataSource Bean。这种配置方式简洁且易于维护，是推荐的生产环境做法。
# application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC
username: root
password: password
driver-class-name: com.mysql.cj.jdbc.Driver
hikari:
maximum-pool-size: 10
minimum-idle: 5
connection-timeout: 30000
idle-timeout: 600000
max-lifetime: 1800000
pool-name: MyHikariPool
在 YAML 格式中，HikariCP 的属性名采用 kebab-case（短横线命名），例如 maximum-pool-size 对应 Java 中的 setMaximumPoolSize。Spring Boot 会自动将这些属性映射到 HikariConfig 对象。如果未指定某些参数，HikariCP 会使用其内置的合理默认值，但显式声明关键参数仍是最佳实践。
当 maximumPoolSize 设置为 0 时会发生什么？
当 maximumPoolSize 被设置为 0 或负数时，HikariCP 会在初始化阶段直接抛出 IllegalArgumentException，提示“maximumPoolSize cannot be 0 or less”。这是因为连接池至少需要维持一个连接才能正常工作，设置为 0 意味着没有可用连接，这在逻辑上是无效的。开发者在配置时必须确保该值大于等于 1，通常建议根据实际业务负载设置为 5 到 20 之间的整数。
