Spring多数据源场景下Hikari连接池配置层级及属性查询

问题1答案 #

是必须遵循固定配置层级，否则@ConfigurationProperties注解无法完成属性绑定，你写的Hikari参数不会被注入到数据源实例中。

问题2答案 #

结合你当前的代码写法，配置层级规则如下：

1. 基础连接参数（url、用户名、密码、驱动类名）放在spring.datasource.db-write节点下，这部分会被dataSourcePropertiesDbWrite()方法上的@ConfigurationProperties("spring.datasource.db-write")读取，对应DataSourceProperties类的通用属性。
2. Hikari连接池专属参数放在spring.datasource.db-write.configuration节点下，这部分会被dataSourceDbWrite()方法上的@ConfigurationProperties("spring.datasource.db-write.configuration")读取，直接绑定到HikariDataSource实例的对应字段上。

完整配置示例：

spring:
  datasource:
    db-write:
      url: jdbc:sqlserver://whatever.database.windows.net:1433;database=dbname;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;
      username: 'myusername'
      password: 'mynotsosecretpassword'
      driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
      # Hikari连接池参数统一放在configuration节点下
      configuration:
        connection-timeout: 30000
        maximum-pool-size: 20
        minimum-idle: 5
        idle-timeout: 600000
        max-lifetime: 1800000
        pool-name: WriteDbPool
        connection-test-query: SELECT 1

注意：参数名必须使用短横线命名法（kebab-case），比如maximumPoolSize对应配置项是maximum-pool-size，和Spring Boot的属性绑定规则一致。
额外提醒：如果后续你添加第二个读数据源，记得@Primary注解只能加在其中一个数据源的相关Bean上，否则Spring启动时会出现重复主Bean的报错。

问题3答案 #

查询Hikari支持的可配置参数有3个靠谱途径，优先推荐前两种，不会出现版本不匹配问题：

• 直接看项目引入的HikariCP依赖中的com.zaxxer.hikari.HikariConfig类源码，这个类里所有带setter方法的字段都是可配置项，字段注释里明确写了参数作用、默认值、合法取值范围，是最准确的一手资料。
• 用支持Spring Boot配置提示的IDE（比如IDEA、Spring Tool Suite）写yml/properties配置时，在spring.datasource.db-write.configuration节点下触发自动补全，IDE会列出所有当前版本支持的配置项，附带默认值和说明。
• 查看你当前引入的HikariCP版本对应的官方开源项目文档，配置章节会列出所有公开参数和最佳实践说明。

内容的提问来源于stack exchange，提问作者Em Ae