springboot配置HikariDataSource连接池的两种方法

 更新时间:2026年01月21日 09:13:56   作者:遇晚风  
本文介绍了在Spring Boot中配置HikariDataSource连接池的两种方式,通过application.yml或application.properties文件可以设置数据库连接信息及Hikari连接池参数,感兴趣的可以了解一下

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

1. application.yml 配置方式

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 配置方式

# 数据库连接信息
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连接池允许的最大连接数5-20(根据并发量调整,不宜过大,避免数据库压力)
minimum-idle维持的最小空闲连接数5-10(避免频繁创建连接)
connection-timeout获取连接的超时时间30000ms(30 秒,超过则抛连接超时异常)
max-lifetime连接的最大存活时间小于数据库的 wait_timeout(MySQL 默认 8 小时,建议 30 分钟)
idle-timeout空闲连接的超时时间10 分钟(释放长期空闲的连接,避免资源浪费)
connection-test-query测试连接有效性的 SQLSELECT 1(MySQL)、SELECT 1 FROM DUAL(Oracle)

自定义配置类(可选)

如果需要通过代码自定义 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,确保获取的连接是有效的。

到此这篇关于springboot配置HikariDataSource连接池的两种方法的文章就介绍到这了,更多相关springboot配置HikariDataSource连接池内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • java 动态生成bean的案例

    java 动态生成bean的案例

    这篇文章主要介绍了java 动态生成bean的案例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-02-02
  • Java获取Cookie里的指定值的实现方法

    Java获取Cookie里的指定值的实现方法

    在Java中,我们经常需要从HTTP请求中获取Cookie,并从中提取特定的值,下面我们将介绍如何通过Java代码获取Cookie中的指定值,文章通过代码示例介绍的非常详细,需要的朋友可以参考下
    2024-09-09
  • Java实现大文件的分片上传与下载(springboot+vue3)

    Java实现大文件的分片上传与下载(springboot+vue3)

    这篇文章主要为大家详细介绍了java基于springboot+vue3如何大文件的分片上传与下载,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2023-06-06
  • MyBatis实现if-else的示例代码

    MyBatis实现if-else的示例代码

    MyBatis实现if-else功能可以通过和标签来完成,这些标签提供了一种类似于Java中switch语句的方式来处理多分支条件逻辑,下面就来具体了解一下
    2025-11-11
  • 使用spring整合Quartz实现—定时器功能

    使用spring整合Quartz实现—定时器功能

    这篇文章主要介绍了使用spring整合Quartz实现—定时器功能,不基于特定的基类的方法,需要的朋友可以参考下
    2018-04-04
  • Springboot 实现数据库备份还原的方法

    Springboot 实现数据库备份还原的方法

    这篇文章主要介绍了Springboot 实现数据库备份还原的方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-09-09
  • Kotlin基础教程之dataclass,objectclass,use函数,类扩展,socket

    Kotlin基础教程之dataclass,objectclass,use函数,类扩展,socket

    这篇文章主要介绍了Kotlin基础教程之dataclass,objectclass,use函数,类扩展,socket的相关资料,需要的朋友可以参考下
    2017-05-05
  • Spring事务的失效场景你知道多少

    Spring事务的失效场景你知道多少

    这篇文章主要为大家详细介绍了Spring事务的失效场景,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-03-03
  • 详解Java 二叉树的实现和遍历

    详解Java 二叉树的实现和遍历

    二叉树可以简单理解为对于一个节点来说,最多拥有一个上级节点,同时最多具备左右两个下级节点的数据结构。本文将详细介绍一下Java中二叉树的实现和遍历,需要的可以参考一下
    2022-01-01
  • Java获取磁盘空间的两种代码示例

    Java获取磁盘空间的两种代码示例

    这篇文章主要介绍了Java获取磁盘空间的两种代码示例,没什么事的时候可以拿来玩玩,需要的朋友参考下。
    2017-11-11

最新评论