<think>我们正在处理的是 HikariCP 连接池在使用过程中出现的
JDBC 连接异常问题，具体异常为：
`
Caused by: org.hibernate.exception
.JDBCConnectionException
: Unable to acquire
JDBC Connection`
根据引用[1]中提供的配置，我们可以知道在Spring Boot中配置HikariCP连接池的方法。同时，引用[2][3][4]也提到了一些可能导致连接异常的原因，如Jar包冲突、连接提供者配置、
数据库连接参数错误等。
### 问题分析
1
. **
数据库连接参数错误**：如URL、用户名、密码不正确（引用[4]）
2
. **连接池配置不当**：如连接超时时间、最大连接数等设置不合理（引用[1]）
3
. **网络问题**：
数据库服务器不可达（引用[4]中检查MySQL是否开启）
4
. **Jar包冲突**：如不同版本的commons-collections包（引用[2]）
5
. **连接泄漏**：应用程序未正确关闭
数据库连接
6
. **
数据库连接超过最大限制**：
数据库端的最大连接数限制
### 解决方案
#### 1
. 检查
数据库连接参数
- 确保`application
.properties`（或`application
.yml`）中的
数据库连接参数正确：
```properties
spring
.datasource
.url=
jdbc:mysql
://localhost
:3306/dbname?serverTimezone=GMT%2B8&characterEncoding=utf8
spring
.datasource
.username=root
spring
.datasource
.password=yourpassword
```
注意：`serverTimezone`参数对于MySQL 8
.0以上版本很重要，避免时区问题。
#### 2
. 优化HikariCP连接池配置
根据引用[1]的配置示例，调整以下参数（特别是超时相关参数）：
```properties
# 连接池类型
spring
.datasource
.type=com
.zaxxer
.hikari
.HikariDataSource
# 最小空闲连接数
spring
.datasource
.hikari
.minimum-idle=5
# 最大连接池大小
spring
.datasource
.hikari
.maximum-pool-size=20
# 连接最大存活时间（毫秒），建议小于
数据库的wait_timeout
spring
.datasource
.hikari
.max-lifetime=1800000 # 30分钟
# 连接超时时间（毫秒）
spring
.datasource
.hikari
.connection-timeout=30000
# 空闲连接超时时间（毫秒）
spring
.datasource
.hikari
.idle-timeout=300000 # 5分钟
# 连接测试查询
spring
.datasource
.hikari
.connection-test-query=SELECT 1
```
注意：`max-lifetime`必须小于
数据库的`wait_timeout`（默认8小时），否则
数据库会关闭连接而连接池还在使用。
#### 3
. 检查
数据库服务器状态和网络
- 确保
数据库服务正在运行
- 检查网络是否通畅，使用`telnet`命令测试
数据库端口（如3306）是否可达
#### 4
. 解决Jar包冲突
如引用[2]所述，检查是否有冲突的Jar包（如commons-collections），使用Maven依赖树分析：
```bash
mvn dependency
:tree
```
排除冲突的依赖，例如：
```xml
<dependency>
<groupId>group</groupId>
<artifactId>artifact</artifactId>
<exclusions>
<exclusion>
<groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId>
</exclusion>
</exclusions>
</dependency>
```
#### 5
. 检查
数据库连接数限制
- 查看
数据库当前连接数：
```sql
SHOW STATUS LIKE 'Threads_connected';
```
- 查看最大连接数：
```sql
SHOW VARIABLES LIKE 'max_
connections';
```
如果连接数接近最大值，需要调整
数据库的`max_
connections`参数。
#### 6
. 启用连接池监控
在Spring Boot中启用HikariCP监控，添加以下配置：
```properties
# 启用Hikari连接池监控
management
.endpoints
.web
.exposure
.include=health,info,metrics
management
.metrics
.export
.prometheus
.enabled=true
management
.endpoint
.health
.show-details=always
```
通过`/actua
tor/health`端点可以查看
数据库连接状态。
#### 7
. 检查连接泄漏
在开发环境启用泄漏检测：
```properties
# 检测连接泄漏（生产环境不建议开启，性能影响）
spring
.datasource
.hikari
.leak-detection-threshold=2000 # 2秒
```
如果连接超过指定时间未关闭，会记录警告日志。
### 故障排查步骤
```mermaid
graph TD
A[
JDBC连接异常] --> B[检查
数据库参数]
A --> C[检查网络连通性]
A --> D[检查连接池配置]
A --> E[检查Jar包冲突]
A --> F[检查
数据库连接数]
B -->|错误| G[修正参数]
C -->|不可达| H[修复网络]
D -->|配置不当| I[优化配置]
E -->|冲突| J[排除冲突]
F -->|满额| K[增大max_
connections]
```
### 常见错误场景
1
. **连接超时**：`
connection-timeout`设置过短，网络波动时无法建立连接
2
. **连接被
数据库关闭**：`max-lifetime`大于
数据库`wait_timeout`，导致连接被
数据库关闭而连接池还在使用
3
. **连接泄漏**：程序未关闭连接，连接池中的连接耗尽
### 参考配置模板
```properties
# 基本配置
spring
.datasource
.url=
jdbc:mysql
://localhost
:3306/test?useSSL=false&serverTimezone=Asia/Shanghai
spring
.datasource
.username=root
spring
.datasource
.password=root
# HikariCP配置
spring
.datasource
.hikari
.connection-timeout=30000
spring
.datasource
.hikari
.idle-timeout=600000
spring
.datasource
.hikari
.max-lifetime=1800000
spring
.datasource
.hikari
.maximum-pool-size=20
spring
.datasource
.hikari
.minimum-idle=5
spring
.datasource
.hikari
.connection-test-query=SELECT 1
```
> **重要提示**：生产环境修改配置后务必进行压力测试，确保连接池配置合理[^1]。
§§相关问题§§
1
. HikariCP连接池的`max-lifetime`和
数据库`wait_timeout`应该如何协调？
2
. 如何通过Spring Boot Actua
tor监控HikariCP连接池状态？
3
. 有哪些常见的
JDBC连接泄漏排查方法？
4
. 如何解决
数据库连接数超过最大值的问题？</think>### HikariCP 连接池 `
JDBCConnectionException` 解决方案
#### 一、核心问题定位
当出现 `
org.hibernate.exception
.JDBCConnectionException
: Unable to acquire
JDBC Connection` 错误时，通常由以下原因导致：
1
. **连接池配置错误**：超时时间、连接数等参数不合理（引用[1]）
2
. **
数据库连接参数错误**：URL、用户名、密码不正确（引用[4]）
3
. **JAR包冲突**：如 `commons-collections` 版本冲突（引用[2]）
4
. **连接泄漏**：未正确释放
数据库连接
5
. **网络/
数据库问题**：
数据库服务不可达或过载
#### 二、解决方案步骤
```mermaid
graph TD
A[异常出现] --> B{检查基础配置}
B -->|错误| C[修正URL/账号/密码]
B -->|正确| D{检查连接池参数}
D -->|异常| E[优化HikariCP配置]
D -->|正常| F{检查JAR包冲突}
F -->|存在| G[排除冲突依赖]
F -->|无| H{检查连接泄漏}
H -->|泄漏| I[添加泄漏检测]
H -->|无泄漏| J[检查
数据库状态]
```
##### 1
. 验证基础连接配置（首要）
在 `application
.properties` 中检查：
```properties
# 必检项（引用[1][4]）
spring
.datasource
.url=
jdbc:mysql
://localhost
:3306/真实
数据库名?serverTimezone=GMT%2B8
spring
.datasource
.username=root # 替换实际用户名
spring
.datasource
.password=root # 替换实际密码
# 验证命令（需安装mysql-client）
mysql -u root -p -h localhost
```
##### 2
. 优化HikariCP配置（关键）
```properties
# 连接池核心配置（引用[1]）
spring
.datasource
.hikari
.connection-timeout=30000 # 连接超时(ms)
spring
.datasource
.hikari
.idle-timeout=600000 # 空闲超时(>
数据库wait_timeout)
spring
.datasource
.hikari
.max-lifetime=1800000 # 连接最大生命周期
spring
.datasource
.hikari
.maximum-pool-size=20 # 根据DB的max_
connections调整
spring
.datasource
.hikari
.leak-detection-threshold=5000 # 泄漏检测(ms)
# 必须添加的心跳检测
spring
.datasource
.hikari
.connection-test-query=SELECT 1
```
##### 3
. 解决JAR包冲突（常见陷阱）
```xml
<!-- 检查pom
.xml排除冲突包（引用[2]） -->
<dependency>
<groupId>
org.springframework
.boot</groupId>
<artifactId>spring-boot-starter-
jdbc</artifactId>
<exclusions>
<exclusion>
<groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId> <!-- 冲突常见包 -->
</exclusion>
</exclusions>
</dependency>
<!-- 执行依赖树检查 -->
mvn dependency
:tree | grep 'commons-collections'
```
> 保留单一版本的 `commons-collections`（推荐3
.2
.2+）
##### 4
. 连接泄漏检测与修复
在开发环境启用监控：
```properties
# 开启Hikari连接泄漏日志（生产环境慎用）
spring
.datasource
.hikari
.leak-detection-threshold=2000
```
代码修复示例：
```
java
// 错误示例：未关闭连接
try (
Connection conn = dataSource
.get
Connection()) { //
Java 7+自动关闭
Statement stmt = conn
.createStatement();
ResultSet rs = stmt
.executeQuery("SELECT
...");
//
...
} // 此处自动调用conn
.close()
```
##### 5
. 数据库端检查
```sql
-- 检查最大连接数
SHOW VARIABLES LIKE 'max_
connections';
-- 检查活跃连接
SHOW STATUS LIKE 'Threads_connected';
-- 修改最大连接数（需重启）
SET GLOBAL max_
connections = 200;
```
#### 三、特殊场景处理
1
. **SSH/老旧项目问题**（引用[3][4]）
在 `
hibernate.cfg
.xml` 中添加：
```xml
<property name="
hibernate.connection.provider_class">
org.hibernate.hikaricp
.internal
.HikariCP
ConnectionProvider
</property>
```
2
. **云
数据库连接问题**
添加白名单：
```sql
GRANT ALL PRIVILEGES ON *
.*
TO 'user'@'公网IP' IDENTIFIED
BY 'password';
```
3
. **连接池初始化失败**
在启动类添加：
```
java
@SpringBootApplication(exclude = {DataSourceAu
toConfiguration
.class})
```
#### 四、诊断工具
1
. **监控连接池状态**：
```
java
HikariDataSource ds = (HikariDataSource) dataSource;
System
.out
.println("活跃连接
: " + ds
.getHikariPoolMXBean()
.getActive
Connections());
System
.out
.println("空闲连接
: " + ds
.getHikariPoolMXBean()
.getIdle
Connections());
```
2
. **日志配置**（查看详细错误）：
```properties
logging
.level
.com
.zaxxer
.hikari=DEBUG
logging
.level
.org.hibernate.SQL=DEBUG
```
> **关键建议**：85%的此类错误由配置错误或连接泄漏引起，优先检查连接字符串和连接池超时参数[^1][^4]。生产环境修改后务必进行压力测试！
本文解决了在使用Hibernate时配置数据库路径导致的连接错误问题，通过修改配置文件中的URL格式，从jdbc:mysql://更改为jdbc:mysql://，成功解决了无法建立到MySQL数据库连接的问题。
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
