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

更新時(shí)間：2026年01月21日 09:13:56 作者：遇晚風(fēng)

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

1. application.yml 配置方式

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

2. application.properties 配置方式

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

關(guān)鍵配置項(xiàng)說明

配置項(xiàng)	作用	建議值
maximum-pool-size	連接池允許的最大連接數(shù)	5-20（根據(jù)并發(fā)量調(diào)整，不宜過大，避免數(shù)據(jù)庫壓力）
minimum-idle	維持的最小空閑連接數(shù)	5-10（避免頻繁創(chuàng)建連接）
connection-timeout	獲取連接的超時(shí)時(shí)間	30000ms（30 秒，超過則拋連接超時(shí)異常）
max-lifetime	連接的最大存活時(shí)間	小于數(shù)據(jù)庫的 wait_timeout（MySQL 默認(rèn) 8 小時(shí)，建議 30 分鐘）
idle-timeout	空閑連接的超時(shí)時(shí)間	10 分鐘（釋放長期空閑的連接，避免資源浪費(fèi)）
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ù)據(jù)庫連接信息
        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);
    }
}

注意事項(xiàng)

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

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

您可能感興趣的文章: