springboot配置HikariDataSource連接池的兩種方法

更新時間：2026年01月21日 09:13:56 作者：遇晚風

本文介紹了在Spring?Boot中配置HikariDataSource連接池的兩種方式,通過application.yml或application.properties文件可以設置數(shù)據庫連接信息及Hikari連接池參數(shù),感興趣的可以了解一下

1. application.yml 配置方式

spring:
  datasource:
    # 數(shù)據庫連接信息
    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:
      # 連接池名稱（顯示在日志和監(jiān)控中）
      pool-name: MyHikariPool
      
      # 最大連接數(shù)（默認10，建議根據并發(fā)量調整）
      maximum-pool-size: 20
      
      # 最小空閑連接數(shù)（默認等于maximum-pool-size，建議設置為5-10）
      minimum-idle: 5
      
      # 連接超時時間（毫秒，默認30000ms=30秒）
      connection-timeout: 30000
      
      # 連接最大存活時間（毫秒，默認1800000ms=30分鐘，建議小于數(shù)據庫wait_timeout）
      max-lifetime: 1800000
      
      # 空閑連接超時時間（毫秒，默認600000ms=10分鐘，設置為0表示永不超時）
      idle-timeout: 600000
      
      # 測試連接是否有效（建議配置，避免使用失效連接）
      connection-test-query: SELECT 1

2. application.properties 配置方式

# 數(shù)據庫連接信息
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

關鍵配置項說明

配置項	作用	建議值
maximum-pool-size	連接池允許的最大連接數(shù)	5-20（根據并發(fā)量調整，不宜過大，避免數(shù)據庫壓力）
minimum-idle	維持的最小空閑連接數(shù)	5-10（避免頻繁創(chuàng)建連接）
connection-timeout	獲取連接的超時時間	30000ms（30 秒，超過則拋連接超時異常）
max-lifetime	連接的最大存活時間	小于數(shù)據庫的 wait_timeout（MySQL 默認 8 小時，建議 30 分鐘）
idle-timeout	空閑連接的超時時間	10 分鐘（釋放長期空閑的連接，避免資源浪費）
connection-test-query	測試連接有效性的 SQL	SELECT 1（MySQL）、SELECT 1 FROM DUAL（Oracle）

自定義配置類（可選）

如果需要通過代碼自定義 HikariDataSource，可以創(chuàng)建配置類：

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();
        
        // 數(shù)據庫連接信息
        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);
    }
}

注意事項

Spring Boot 2.x 及以上默認使用 HikariCP，無需額外引入依賴（已包含在 spring-boot-starter-jdbc 或 spring-boot-starter-data-jpa 中）。
配置時需確保 max-lifetime 小于數(shù)據庫的 wait_timeout（避免數(shù)據庫主動關閉連接后，連接池仍持有無效連接）。
生產環(huán)境建議配置 connection-test-query，確保獲取的連接是有效的。

到此這篇關于springboot配置HikariDataSource連接池的兩種方法的文章就介紹到這了,更多相關springboot配置HikariDataSource連接池內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: