Spring Boot Web应用中如何配置Hikari连接池大小及其他属性

我们使用默认的HikariPool-1作为数据源连接池，想要配置最大连接数、初始大小等属性，但遇到两类问题：部分配置导致应用启动崩溃，另一部分配置启动成功但完全不生效，连接池仍保持默认的10个连接。

问题场景回顾 #

• 导致启动崩溃的配置：

  spring.datasource.hikari.maximumPoolSize = 120
  spring.datasource.hikari.minimumIdle=20
  

  或

  spring.datasource.hikari.minimum-idle=20
  spring.datasource.hikari.maximum-pool-size=200
  

• 启动成功但配置无效的配置：

  spring.datasource.hikari.minimum-idle=20
  spring.datasource.hikari.maximum-pool-size=200
  

问题原因分析 #

1. 启动崩溃原因
   • 参数值超出数据库承载上限：比如MySQL默认最大连接数为151，若Hikari的maximum-pool-size设为200，会导致数据库拒绝新连接，触发应用启动失败。
   • 初始化连接失败直接终止：默认情况下，Hikari初始化连接失败会抛出异常终止应用，没有重试机制。
2. 配置不生效原因
   • 配置文件类型与命名风格不匹配：比如在YAML配置文件中误用驼峰式命名，导致Spring无法正确绑定参数。
   • 配置被代码或其他配置文件覆盖：比如代码中手动创建了HikariDataSource实例且未读取配置，或者优先级更高的配置文件覆盖了当前设置。

正确配置方案 #

1. 匹配配置文件的命名风格 #

• properties文件：两种风格均支持，推荐短横线式（更符合Spring配置规范）：

  # 核心配置
  spring.datasource.hikari.minimum-idle=20
  spring.datasource.hikari.maximum-pool-size=100
  # 可选：初始化失败时自动重试，避免启动崩溃
  spring.datasource.hikari.initialization-fail-timeout=0
  # 可选：设置连接超时时间，默认30000ms
  spring.datasource.hikari.connection-timeout=30000
  

• YAML文件：必须用短横线式，注意缩进层级：

  spring:
    datasource:
      hikari:
        minimum-idle: 20
        maximum-pool-size: 100
        initialization-fail-timeout: 0
        connection-timeout: 30000
  

2. 合理设置参数值 #

• 确保maximum-pool-size小于数据库的最大连接数（比如MySQL可通过show variables like 'max_connections';查看），建议预留20个左右的连接给其他系统使用。
• minimum-idle建议设置为与maximum-pool-size相同，避免连接池频繁创建销毁连接，提升性能。

3. 验证配置是否生效 #

• 日志验证：启动应用后，搜索日志中的HikariPool-1，会输出类似以下内容，确认参数是否正确加载：

  HikariPool-1 - Start completed.
  HikariPool-1 - Configured maximum size: 100, minimum idle: 20

• 代码验证：添加一段代码直接读取连接池配置：

  @Autowired
  private DataSource dataSource;
  
  @PostConstruct
  public void verifyHikariConfig() {
      if (dataSource instanceof HikariDataSource) {
          HikariDataSource hikariDS = (HikariDataSource) dataSource;
          System.out.println("当前最大连接数：" + hikariDS.getMaximumPoolSize());
          System.out.println("当前最小空闲连接数：" + hikariDS.getMinimumIdle());
      }
  }
  

额外排查点 #

• 检查是否存在手动创建HikariDataSource的代码：若代码中手动实例化连接池且未读取配置文件参数，会覆盖配置，需修改代码读取配置。
• 确认配置文件优先级：比如当前激活的环境（dev/prod）对应的配置文件是否是你修改的那一个，避免配置被其他文件覆盖。
• 核对Spring Boot版本：2.x及以上版本默认使用Hikari，配置前缀为spring.datasource.hikari.*，若为1.x版本需检查对应配置规则。

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