在 Spring Boot 2.x / 3.x 項(xiàng)目中，HikariCP 已經(jīng)成為默認(rèn)數(shù)據(jù)庫連接池。
但很多人對它的參數(shù)一知半解，甚至直接照抄配置，結(jié)果線上問題頻發(fā)。

一、為什么要用數(shù)據(jù)庫連接池？

每次訪問數(shù)據(jù)庫，如果都經(jīng)歷：

1. 創(chuàng)建 TCP 連接
2. MySQL 身份驗(yàn)證
3. 執(zhí)行 SQL
4. 關(guān)閉連接

這些操作非常耗時(shí)，在并發(fā)場景下會嚴(yán)重拖慢系統(tǒng)性能。

?? 數(shù)據(jù)庫連接池的作用就是：

• 預(yù)先創(chuàng)建好一定數(shù)量的數(shù)據(jù)庫連接
• 請求來了直接復(fù)用
• 用完放回池中
• 避免頻繁創(chuàng)建 / 銷毀連接

二、什么是 HikariCP？

HikariCP 是一個(gè)高性能 JDBC 連接池實(shí)現(xiàn)，也是：

• ? Spring Boot 官方默認(rèn)連接池
• ? 目前主流連接池中性能最優(yōu)
• ? 設(shè)計(jì)目標(biāo)：快、輕量、簡單

Spring Boot 3.x 中，哪怕你什么都不配置，底層默認(rèn)用的就是它。

三、典型 Hikari 配置示例

spring:
  datasource:
    hikari:
      connection-test-query: SELECT 1
      connection-timeout: 60000
      idle-timeout: 500000
      max-lifetime: 540000
      maximum-pool-size: 10
      minimum-idle: 5
      pool-name: AiReportHikariPool

下面我們逐個(gè)參數(shù)拆開講。

四、Hikari 核心參數(shù)詳解

1?? connection-test-query

connection-test-query: SELECT 1

作用：

• 用于檢測數(shù)據(jù)庫連接是否可用

是否必須？

• ? 大多數(shù)情況下不需要
• Hikari 默認(rèn)使用 JDBC4 的 isValid() 方法，性能更好

建議：

# MySQL / PostgreSQL 可直接刪除
# connection-test-query: SELECT 1

2?? connection-timeout（非常重要）

connection-timeout: 60000

作用：

• 從連接池獲取連接時(shí)，最多等待多久
• 超過時(shí)間直接拋異常

風(fēng)險(xiǎn)：

• 時(shí)間過長（60 秒）會導(dǎo)致線程長時(shí)間阻塞
• 在高并發(fā)下可能拖垮整個(gè)服務(wù)

推薦值：

connection-timeout: 30000

3?? idle-timeout

idle-timeout: 500000

作用：

• 空閑連接在池中能存活的最長時(shí)間
• 超時(shí)后會被回收

建議：

idle-timeout: 300000  # 5 分鐘

4?? max-lifetime（非常重要）

max-lifetime: 540000

作用：

• 一個(gè)連接在池中的最大生命周期
• 到期后強(qiáng)制銷毀并重建

為什么需要？

• 防止數(shù)據(jù)庫（如 MySQL）主動斷開“老連接”

重要規(guī)則：

max-lifetime > idle-timeout

推薦值：

max-lifetime: 1800000  # 30 分鐘

5?? maximum-pool-size

maximum-pool-size: 10

作用：

• 連接池允許的最大連接數(shù)

經(jīng)驗(yàn)值：

? 并不是越大越好，數(shù)據(jù)庫本身也有連接上限

6?? minimum-idle

minimum-idle: 5

作用：

• 保持的最小空閑連接數(shù)

建議：

• 一般設(shè)置為 maximum-pool-size 的一半左右
• 不要和最大連接數(shù)相同，否則連接永不釋放

7?? pool-name

pool-name: AiReportHikariPool

作用：

• 連接池名稱
• 僅用于日志和監(jiān)控識別

建議：

• 給每個(gè)服務(wù)一個(gè)有意義的名字，方便排查問題

五、常見錯(cuò)誤配置總結(jié)

? 連接生命周期太短
? connection-timeout 設(shè)太大
? max-lifetime 小于 idle-timeout
? 盲目把 pool-size 調(diào)很大

這些都會導(dǎo)致：

• 連接頻繁重建
• 吞吐下降
• 數(shù)據(jù)庫壓力異常

六、推薦的「穩(wěn)定生產(chǎn)配置」

spring:
  datasource:
    hikari:
      connection-timeout: 30000
      idle-timeout: 300000
      max-lifetime: 1800000
      maximum-pool-size: 10
      minimum-idle: 5
      pool-name: AiReportHikariPool

?? 適合 90% 中小型 Spring Boot 項(xiàng)目

七、總結(jié)

HikariCP 的核心思想不是“多”和“復(fù)雜”，
而是“剛剛好”和“足夠快”。

到此這篇關(guān)于Spring Boot 默認(rèn)數(shù)據(jù)庫連接池 HikariCP全文解析的文章就介紹到這了,更多相關(guān)springboot數(shù)據(jù)庫連接池 HikariCP內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論