SpringBoot项目中HikariCP的keepAliveTime配置无法生效问题

问题核心原因 #

造成keepAliveTime配置不生效的原因主要有两个：

1. 版本适配问题
   keepAliveTime是HikariCP 3.4.0版本才新增的配置参数，Spring Boot 2.4.0之前的版本，官方自动配置类HikariDataSourceProperties未提供该参数的绑定逻辑，即便写在配置文件中也不会被加载。
2. 参数规则冲突
   HikariCP强制要求keepAliveTime必须小于maxLifetime，你当前配置中hikari.max-lifetime设为48000ms（48秒），而keepaliveTime设为80000ms（80秒），违反了该规则，就算参数绑定成功也会被HikariCP直接忽略。

解决步骤 #

步骤1：版本适配（二选一即可）

• 方案1：升级Spring Boot版本到2.4.0及以上，自带适配HikariCP的keepAliveTime参数绑定
• 方案2：如果不希望升级Spring Boot版本，手动声明HikariDataSource Bean并设置参数

@Configuration
public class DataSourceConfig {
    @Bean
    @ConfigurationProperties(prefix = "spring.datasource.hikari")
    public HikariDataSource dataSource() {
        HikariDataSource dataSource = new HikariDataSource();
        // 手动设置keepAliveTime，单位为毫秒
        dataSource.setKeepaliveTime(80000);
        return dataSource;
    }
}

步骤2：修正参数冲突

调整max-lifetime的取值，使其大于keepAliveTime，例如设置为600000ms（10分钟），符合HikariCP的参数规则。

步骤3：修正配置写法

无需在datasource根路径下重复配置keepaliveTime，仅保留spring.datasource.hikari下的配置即可，推荐使用Spring Boot规范的kebab-case命名：

spring:
  datasource:
    jdbc-url: jdbc:postgresql://x.x.x.x:5433/xxx?sslmode=require&sslcert=/file.crt&sslkey=/tmp/file.key
    username: ${JDBC_USERNAME}
    password: ${JDBC_PASSWORD}
    jpa:
      hibernate:
        ddl-auto: update
      show-sql: true
      properties:
        hibernate.format_sql: true
        hibernate.dialect: org.hibernate.dialect.PostgreSQL81Dialect
    hikari:
      idle-timeout: 500000
      minimum-idle: 10
      maximum-pool-size: 15
      keep-alive-time: 80000
      max-lifetime: 600000 # 调整为大于keep-alive-time的取值
      connection-timeout: 180000

验证方式 #

项目启动后可以通过注入HikariDataSource实例打印参数确认是否生效：

@Autowired
private HikariDataSource hikariDataSource;

@PostConstruct
public void checkHikariConfig() {
    System.out.println("当前keepAliveTime配置值：" + hikariDataSource.getKeepaliveTime());
}

内容的提问来源于stack exchange，提问作者Aman Kumar Sinha