Spring Boot中使用DataSource Bean时如何配置Hikari连接池参数

环境：Spring Boot 3.4.2、Java 21
我们无法使用自动装配的DataSource，因为数据库凭证等信息来自AWS Secrets Manager。当前application.properties中的Hikari连接池配置被完全忽略：

spring.datasource.hikari.connectionTimeout=60000
spring.datasource.hikari.maximumPoolSize=50
spring.datasource.hikari.idleTimeout=1200000 
spring.datasource.hikari.maxLifetime=3000000 
spring.datasource.hikari.poolName=my-pool

我们自定义的DataSource配置Bean如下：

@Configuration
public class DataSourceConfig extends HikariConfig {
    @Bean
    public DataSource getDataSource() {

        DataSourceBuilder<?> dataSourceBuilder = DataSourceBuilder.create();
        dataSourceBuilder.driverClassName(driverClassName);
        awsSecretsManagerUtility().setSecretName(dbSecretName);
        AWSSecretsManagerUtility.RDSSecret rdsSecret = awsSecretsManagerUtility().getSecretData(AWSSecretsManagerUtility.RDSSecret.class);
        url = String.format("jdbc:postgresql://%s:%s/%s", rdsSecret.getHost(), rdsSecret.getPort(), rdsSecret.getDbname());
        username = rdsSecret.getUsername();
        password = rdsSecret.getPassword();

        dataSourceBuilder.url(url);
        dataSourceBuilder.username(username);
        dataSourceBuilder.password(password);
        return dataSourceBuilder.build();
    }

    @Bean
    public AWSSecretsManagerUtility awsSecretsManagerUtility() {
        return new AWSSecretsManagerUtility();
    }
}

应用启动日志显示连接池参数未生效：

Database JDBC URL [Connecting through datasource 'HikariDataSource (HikariPool-1)']
Database driver: undefined/unknown
Database version: 16.2
Autocommit mode: undefined/unknown
Isolation level: undefined/unknown
Minimum pool size: undefined/unknown
Maximum pool size: undefined/unknown

我们尝试过两种方案但均无效：

1. 在DataSourceConfig中添加DataSourceProperties Bean：

@Bean
    @ConfigurationProperties("spring.datasource")
    public DataSourceProperties regularDataSourceProperties() {
        return new DataSourceProperties();
    }

2. 使用短横线命名的配置参数：

spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=600000
spring.datasource.hikari.max-lifetime=1800000
spring.datasource.hikari.pool-name=my-pool

请问如何正确配置Hikari连接池参数？

问题核心在于：你当前通过DataSourceBuilder.build()创建的数据源，并没有绑定配置文件中的Hikari参数；同时你的DataSourceConfig继承了HikariConfig但未实际利用它构建数据源。以下两种方案可以解决：

方案一：直接利用HikariConfig绑定配置并构建数据源 #

既然DataSourceConfig已经继承HikariConfig，可以通过@ConfigurationProperties直接把配置文件的Hikari参数绑定到该类，再基于它创建HikariDataSource：

@Configuration
@ConfigurationProperties(prefix = "spring.datasource.hikari")
public class DataSourceConfig extends HikariConfig {
    @Value("${db.secret.name}") // 假设你在配置文件中定义了数据库秘钥名称
    private String dbSecretName;

    @Bean
    public DataSource getDataSource() {
        // 从AWS Secrets Manager获取数据库凭证
        AWSSecretsManagerUtility secretsUtility = awsSecretsManagerUtility();
        secretsUtility.setSecretName(dbSecretName);
        AWSSecretsManagerUtility.RDSSecret rdsSecret = secretsUtility.getSecretData(AWSSecretsManagerUtility.RDSSecret.class);
        
        // 设置Hikari核心连接参数
        setDriverClassName("org.postgresql.Driver"); // 明确指定驱动类
        setJdbcUrl(String.format("jdbc:postgresql://%s:%s/%s", rdsSecret.getHost(), rdsSecret.getPort(), rdsSecret.getDbname()));
        setUsername(rdsSecret.getUsername());
        setPassword(rdsSecret.getPassword());
        
        // 基于当前HikariConfig实例创建数据源
        return new HikariDataSource(this);
    }

    @Bean
    public AWSSecretsManagerUtility awsSecretsManagerUtility() {
        return new AWSSecretsManagerUtility();
    }
}

这种方式下，@ConfigurationProperties(prefix = "spring.datasource.hikari")会自动识别配置文件中的参数（驼峰或短横线命名都支持，Spring会自动转换），并绑定到HikariConfig的对应属性上。

方案二：用DataSourceProperties配合DataSourceBuilder绑定配置 #

如果想保留DataSourceBuilder的使用方式，需要将DataSourceProperties读取的配置传递给它，同时明确指定Hikari作为连接池类型：

@Configuration
public class DataSourceConfig {
    @Value("${db.secret.name}")
    private String dbSecretName;

    @Bean
    @ConfigurationProperties(prefix = "spring.datasource")
    public DataSourceProperties dataSourceProperties() {
        return new DataSourceProperties();
    }

    @Bean
    public DataSource getDataSource(DataSourceProperties dataSourceProperties) {
        // 获取AWS数据库凭证
        AWSSecretsManagerUtility secretsUtility = awsSecretsManagerUtility();
        secretsUtility.setSecretName(dbSecretName);
        AWSSecretsManagerUtility.RDSSecret rdsSecret = secretsUtility.getSecretData(AWSSecretsManagerUtility.RDSSecret.class);
        
        // 用DataSourceProperties初始化builder，同时覆盖凭证信息
        return dataSourceProperties.initializeDataSourceBuilder()
                .driverClassName("org.postgresql.Driver")
                .url(String.format("jdbc:postgresql://%s:%s/%s", rdsSecret.getHost(), rdsSecret.getPort(), rdsSecret.getDbname()))
                .username(rdsSecret.getUsername())
                .password(rdsSecret.getPassword())
                .type(HikariDataSource.class) // 明确指定使用Hikari连接池
                .build();
    }

    @Bean
    public AWSSecretsManagerUtility awsSecretsManagerUtility() {
        return new AWSSecretsManagerUtility();
    }
}

这种方式中，DataSourceProperties会读取spring.datasource下的所有配置（包括Hikari参数），再通过initializeDataSourceBuilder()传递给构建器，确保连接池参数生效。

额外注意事项 #

• 确保项目已引入spring-boot-starter-jdbc或spring-boot-starter-data-jpa依赖，它们会自动包含HikariCP。
• 若启动日志仍显示参数为undefined/unknown，可以在创建数据源后主动打印属性验证配置，例如：

HikariDataSource dataSource = new HikariDataSource(this);
System.out.println("Maximum pool size: " + dataSource.getMaximumPoolSize());
return dataSource;

内容的提问来源于stack exchange，提问作者John Little