springboot 配置 HikariDataSource 连接池信息

在 Spring Boot 中配置 HikariDataSource 非常简单，可以通过 application.properties 或 application.yml 文件进行配置。以下是常用的配置项及说明：

1. application.yml 配置方式

yaml

spring:
  datasource:
    # 数据库连接信息
    url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
    
    # Hikari 连接池配置
    hikari:
      # 连接池名称（显示在日志和监控中）
      pool-name: MyHikariPool
      
      # 最大连接数（默认10，建议根据并发量调整）
      maximum-pool-size: 20
      
      # 最小空闲连接数（默认等于maximum-pool-size，建议设置为5-10）
      minimum-idle: 5
      
      # 连接超时时间（毫秒，默认30000ms=30秒）
      connection-timeout: 30000
      
      # 连接最大存活时间（毫秒，默认1800000ms=30分钟，建议小于数据库wait_timeout）
      max-lifetime: 1800000
      
      # 空闲连接超时时间（毫秒，默认600000ms=10分钟，设置为0表示永不超时）
      idle-timeout: 600000
      
      # 测试连接是否有效（建议配置，避免使用失效连接）
      connection-test-query: SELECT 1

2. application.properties 配置方式

properties

# 数据库连接信息
spring.datasource.url=jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# Hikari 连接池配置
spring.datasource.hikari.pool-name=MyHikariPool
spring.datasource.hikari.maximum-pool-size=20
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.max-lifetime=1800000
spring.datasource.hikari.idle-timeout=600000
spring.datasource.hikari.connection-test-query=SELECT 1

关键配置项说明

自定义配置类（可选）

如果需要通过代码自定义 HikariDataSource，可以创建配置类：

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

@Configuration
public class HikariConfig {

    @Bean
    public DataSource dataSource() {
        HikariConfig config = new HikariConfig();
        
        // 数据库连接信息
        config.setJdbcUrl("jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8");
        config.setUsername("root");
        config.setPassword("your_password");
        config.setDriverClassName("com.mysql.cj.jdbc.Driver");
        
        // 连接池配置
        config.setPoolName("CustomHikariPool");
        config.setMaximumPoolSize(20);
        config.setMinimumIdle(5);
        config.setConnectionTimeout(30000);
        config.setMaxLifetime(1800000);
        config.setIdleTimeout(600000);
        config.setConnectionTestQuery("SELECT 1");
        
        return new HikariDataSource(config);
    }
}

注意事项

1. Spring Boot 2.x 及以上默认使用 HikariCP，无需额外引入依赖（已包含在 spring-boot-starter-jdbc 或 spring-boot-starter-data-jpa 中）。
2. 配置时需确保 max-lifetime 小于数据库的 wait_timeout（避免数据库主动关闭连接后，连接池仍持有无效连接）。
3. 生产环境建议配置 connection-test-query，确保获取的连接是有效的。