Spring Boot 数据库连接池参数

Spring Boot 默认选择 Tomcat JDBC Pool 作为数据库连接池。Tomcat（8） 连接池常用的属性：

<col>

属性

描述

默认值

defaultAutoCommit

连接池中创建的连接默认是否自动提交事务

驱动的缺省值

defaultReadOnly

连接池中创建的连接默认是否为只读状态

-

defaultCatalog

连接池中创建的连接默认的 catalog

driverClassName

驱动类的名称

username

数据库账户

password

数据库密码

maxActive

连接池同一时间可分配的最大活跃连接数

100

maxIdle

始终保留在池中的最大连接数，如果启用，将定期检查限制连接，超出此属性设定的值且空闲时间超过minEvictableIdleTimeMillis的连接则释放

与maxActive设定的值相同

minIdle

始终保留在池中的最小连接数，池中的连接数量若低于此值则创建新的连接，如果连接验证失败将缩小至此值

与initialSize设定的值相同

initialSize

连接池启动时创建的初始连接数量

10

maxWait

最大等待时间（毫秒），如果在没有连接可用的情况下等待超过此时间，则抛出异常

30000（30秒）

testOnBorrow

当从连接池中取出一个连接时是否进行验证，若验证失败则从池中删除该连接并尝试取出另一个连接

false

testOnConnect

当一个连接首次被创建时是否进行验证，若验证失败则抛出 SQLException 异常

testOnReturn

当一个连接使用完归还到连接池时是否进行验证

testWhileIdle

对池中空闲的连接是否进行验证，验证失败则回收此连接

validationQuery

在连接池返回连接给调用者前用来对连接进行验证的查询 SQL

null

validationQueryTimeout

SQL 查询验证超时时间（秒），小于或等于 0 的数值表示禁用

-1

timeBetweenEvictionRunsMillis

在空闲连接回收器线程运行期间休眠时间（毫秒）， 该值不应该小于 1 秒，它决定线程多久验证空闲连接或丢弃连接的频率

5000（5秒）

minEvictableIdleTimeMillis

连接在池中保持空闲而不被回收的最小时间（毫秒）

60000（60秒）

removeAbandoned

标记是否删除泄露的连接，如果连接超出removeAbandonedTimeout的限制，且该属性设置为 true，则连接被认为是被泄露并且可以被删除

removeAbandonedTimeout

泄露的连接可以被删除的超时时间（秒），该值应设置为应用程序查询可能执行的最长时间

60

# src/main/resources/application.properties

1

2

3

4

5

6

7

8

9

11

12

13

14

15

16

spring.datasource.url=jdbc:mysql://127.0.0.1/spring_boot_testing_storage

spring.datasource.username=root

spring.datasource.password=root

spring.datasource.driver-class-name=com.mysql.jdbc.Driver

spring.datasource.tomcat.default-auto-commit=true

spring.datasource.tomcat.initial-size=3

spring.datasource.tomcat.max-active=120

spring.datasource.tomcat.max-wait=10000

spring.datasource.tomcat.test-on-borrow=true

spring.datasource.tomcat.test-while-idle=true

spring.datasource.tomcat.validation-query=SELECT 1

spring.datasource.tomcat.validation-query-timeout=3

spring.datasource.tomcat.time-between-eviction-runs-millis=10000

spring.datasource.tomcat.min-evictable-idle-time-millis=120000

spring.datasource.tomcat.remove-abandoned=true

spring.datasource.tomcat.remove-abandoned-timeout=120

Spring Boot Data Jpa 依赖声明：

# pom.xml

&lt;dependency&gt;

&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;

&lt;artifactId&gt;spring-boot-starter-data-jpa&lt;/artifactId&gt;

&lt;/dependency&gt;

Spring Boot 如果发现 Tomcat 连接池不可用，则尝试选择 HikariCP 作为默认连接池。HikariCP 连接池常用的属性：

dataSourceClassName

JDBC 驱动程序提供的 DataSource 类的名称，如果使用了jdbcUrl则不需要此属性

jdbcUrl

数据库连接地址

数据库账户，如果使用了jdbcUrl则需要此属性

数据库密码，如果使用了jdbcUrl则需要此属性

autoCommit

是否自动提交事务

true

connectionTimeout

连接超时时间（毫秒），如果在没有连接可用的情况下等待超过此时间，则抛出 SQLException

idleTimeout

空闲超时时间（毫秒），只有在minimumIdle&lt;maximumPoolSize时生效，超时的连接可能被回收，数值 0 表示空闲连接永不从池中删除

600000（10分钟）

maxLifetime

连接池中的连接的最长生命周期（毫秒）。数值 0 表示不限制

1800000（30分钟）

connectionTestQuery

连接池每分配一条连接前执行的查询语句（如：SELECT 1），以验证该连接是否是有效的。如果你的驱动程序支持 JDBC4，HikariCP 强烈建议我们不要设置此属性

minimumIdle

最小空闲连接数，HikariCP 建议我们不要设置此值，而是充当固定大小的连接池

与maximumPoolSize数值相同

maximumPoolSize

连接池中可同时连接的最大连接数，当池中没有空闲连接可用时，就会阻塞直到超出connectionTimeout设定的数值

poolName

连接池名称，主要用于显示在日志记录和 JMX 管理控制台中

auto-generated

spring.datasource.hikari.auto-commit=true

spring.datasource.hikari.connection-test-query=SELECT 1

spring.datasource.hikari.maximum-pool-size=150

&lt;exclusions&gt;

&lt;exclusion&gt;

&lt;groupId&gt;org.apache.tomcat&lt;/groupId&gt;

&lt;artifactId&gt;tomcat-jdbc&lt;/artifactId&gt;

&lt;/exclusion&gt;

&lt;/exclusions&gt;

&lt;groupId&gt;com.zaxxer&lt;/groupId&gt;

&lt;artifactId&gt;HikariCP&lt;/artifactId&gt;

&lt;version&gt;2.6.1&lt;/version&gt;

Spring Boot 如果发现 HikariCP 连接池不可用，则尝试选择 DBCP 作为默认连接池。DBCP（2） 连接池常用的属性：

url

maxTotal

连接池同一时间可分配的最大活跃连接数；负数表示不限制

可以在池中保持空闲的最大连接数，超出此值的空闲连接被释放，负数表示不限制

可以在池中保持空闲的最小连接数，低于此值将创建空闲连接，若设置为 0，则不创建

maxWaitMillis

最大等待时间（毫秒），如果在没有连接可用的情况下等待超过此时间，则抛出异常；-1 表示无限期等待，直到获取到连接为止

SQL 查询验证超时时间（秒）

testOnCreate

连接在创建之后是否进行验证

对池中空闲的连接是否进行验证，验证失败则释放此连接

在空闲连接回收器线程运行期间休眠时间（毫秒），如果设置为非正数，则不运行此线程

numTestsPerEvictionRun

空闲连接回收器线程运行期间检查连接的个数

removeAbandonedOnBorrow

300（5分钟）

poolPreparedStatements

设置该连接池的预处理语句池是否生效

17

18

19

20

21

spring.jmx.enabled=false

spring.datasource.dbcp2.default-auto-commit=true

spring.datasource.dbcp2.initial-size=30

spring.datasource.dbcp2.max-total=120

spring.datasource.dbcp2.max-idle=120

spring.datasource.dbcp2.min-idle=30

spring.datasource.dbcp2.max-wait-millis=10000

spring.datasource.dbcp2.validation-query=SELECT 1

spring.datasource.dbcp2.validation-query-timeout=3

spring.datasource.dbcp2.test-on-borrow=true

spring.datasource.dbcp2.test-while-idle=true

spring.datasource.dbcp2.time-between-eviction-runs-millis=10000

spring.datasource.dbcp2.num-tests-per-eviction-run=10

spring.datasource.dbcp2.min-evictable-idle-time-millis=120000

spring.datasource.dbcp2.remove-abandoned-on-borrow=true

spring.datasource.dbcp2.remove-abandoned-timeout=120

spring.datasource.dbcp2.pool-prepared-statements=true

&lt;groupId&gt;org.apache.commons&lt;/groupId&gt;

&lt;artifactId&gt;commons-dbcp2&lt;/artifactId&gt;

&lt;version&gt;2.1.1&lt;/version&gt;