Spring Boot 连接池

秒速五厘米 2022-01-14 19:13 265阅读 0赞

[2019独角兽企业重金招聘Python工程师标准>>> ][2019_Python_] ![hot3.png][]

### Tomcat JDBC 连接池 ###

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

<table> 
 <tbody> 
 <tr> 
 <th>属性</th> 
 <th>描述</th> 
 <th>默认值</th> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td>defaultAutoCommit</td> 
 <td>连接池中创建的连接默认是否自动提交事务</td> 
 <td>驱动的缺省值</td> 
 </tr> 
 <tr> 
 <td>defaultReadOnly</td> 
 <td>连接池中创建的连接默认是否为只读状态</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>defaultCatalog</td> 
 <td>连接池中创建的连接默认的 catalog</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>driverClassName</td> 
 <td>驱动类的名称</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>username</td> 
 <td>数据库账户</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>password</td> 
 <td>数据库密码</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>maxActive</td> 
 <td>连接池同一时间可分配的最大活跃连接数</td> 
 <td>100</td> 
 </tr> 
 <tr> 
 <td>maxIdle</td> 
 <td>始终保留在池中的最大连接数，如果启用，将定期检查限制连接，超出此属性设定的值且空闲时间超过minEvictableIdleTimeMillis的连接则释放</td> 
 <td>与maxActive设定的值相同</td> 
 </tr> 
 <tr> 
 <td>minIdle</td> 
 <td>始终保留在池中的最小连接数，池中的连接数量若低于此值则创建新的连接，如果连接验证失败将缩小至此值</td> 
 <td>与initialSize设定的值相同</td> 
 </tr> 
 <tr> 
 <td>initialSize</td> 
 <td>连接池启动时创建的初始连接数量</td> 
 <td>10</td> 
 </tr> 
 <tr> 
 <td>maxWait</td> 
 <td>最大等待时间（毫秒），如果在没有连接可用的情况下等待超过此时间，则抛出异常</td> 
 <td>30000（30秒）</td> 
 </tr> 
 <tr> 
 <td>testOnBorrow</td> 
 <td>当从连接池中取出一个连接时是否进行验证，若验证失败则从池中删除该连接并尝试取出另一个连接</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>testOnConnect</td> 
 <td>当一个连接首次被创建时是否进行验证，若验证失败则抛出 SQLException 异常</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>testOnReturn</td> 
 <td>当一个连接使用完归还到连接池时是否进行验证</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>testWhileIdle</td> 
 <td>对池中空闲的连接是否进行验证，验证失败则回收此连接</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>validationQuery</td> 
 <td>在连接池返回连接给调用者前用来对连接进行验证的查询 SQL</td> 
 <td>null</td> 
 </tr> 
 <tr> 
 <td>validationQueryTimeout</td> 
 <td>SQL 查询验证超时时间（秒），小于或等于 0 的数值表示禁用</td> 
 <td>-1</td> 
 </tr> 
 <tr> 
 <td>timeBetweenEvictionRunsMillis</td> 
 <td>在空闲连接回收器线程运行期间休眠时间（毫秒）， 该值不应该小于 1 秒，它决定线程多久验证空闲连接或丢弃连接的频率</td> 
 <td>5000（5秒）</td> 
 </tr> 
 <tr> 
 <td>minEvictableIdleTimeMillis</td> 
 <td>连接在池中保持空闲而不被回收的最小时间（毫秒）</td> 
 <td>60000（60秒）</td> 
 </tr> 
 <tr> 
 <td>removeAbandoned</td> 
 <td>标记是否删除泄露的连接，如果连接超出removeAbandonedTimeout的限制，且该属性设置为 true，则连接被认为是被泄露并且可以被删除</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>removeAbandonedTimeout</td> 
 <td>泄露的连接可以被删除的超时时间（秒），该值应设置为应用程序查询可能执行的最长时间</td> 
 <td>60</td> 
 </tr> 
 </tbody> 
</table>

\# src/main/resources/application.properties

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 </td> 
 <td> <pre>&nbsp;</pre> 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 </td> 
 </tr> 
 </tbody> 
</table>

\# src/main/resources/application.yml

Spring Boot Data Jpa 依赖声明：

\# pom.xml

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 </td> 
 <td> <pre>&nbsp;</pre> &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; </td> 
 </tr> 
 </tbody> 
</table>

### HikariCP 连接池 ###

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

<table> 
 <tbody> 
 <tr> 
 <th>属性</th> 
 <th>描述</th> 
 <th>默认值</th> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td>dataSourceClassName</td> 
 <td>JDBC 驱动程序提供的 DataSource 类的名称，如果使用了jdbcUrl则不需要此属性</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>jdbcUrl</td> 
 <td>数据库连接地址</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>username</td> 
 <td>数据库账户，如果使用了jdbcUrl则需要此属性</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>password</td> 
 <td>数据库密码，如果使用了jdbcUrl则需要此属性</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>autoCommit</td> 
 <td>是否自动提交事务</td> 
 <td>true</td> 
 </tr> 
 <tr> 
 <td>connectionTimeout</td> 
 <td>连接超时时间（毫秒），如果在没有连接可用的情况下等待超过此时间，则抛出 SQLException</td> 
 <td>30000（30秒）</td> 
 </tr> 
 <tr> 
 <td>idleTimeout</td> 
 <td>空闲超时时间（毫秒），只有在minimumIdle&lt;maximumPoolSize时生效，超时的连接可能被回收，数值 0 表示空闲连接永不从池中删除</td> 
 <td>600000（10分钟）</td> 
 </tr> 
 <tr> 
 <td>maxLifetime</td> 
 <td>连接池中的连接的最长生命周期（毫秒）。数值 0 表示不限制</td> 
 <td>1800000（30分钟）</td> 
 </tr> 
 <tr> 
 <td>connectionTestQuery</td> 
 <td>连接池每分配一条连接前执行的查询语句（如：SELECT 1），以验证该连接是否是有效的。如果你的驱动程序支持 JDBC4，HikariCP 强烈建议我们不要设置此属性</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>minimumIdle</td> 
 <td>最小空闲连接数，HikariCP 建议我们不要设置此值，而是充当固定大小的连接池</td> 
 <td>与maximumPoolSize数值相同</td> 
 </tr> 
 <tr> 
 <td>maximumPoolSize</td> 
 <td>连接池中可同时连接的最大连接数，当池中没有空闲连接可用时，就会阻塞直到超出connectionTimeout设定的数值</td> 
 <td>10</td> 
 </tr> 
 <tr> 
 <td>poolName</td> 
 <td>连接池名称，主要用于显示在日志记录和 JMX 管理控制台中</td> 
 <td>auto-generated</td> 
 </tr> 
 </tbody> 
</table>

\# src/main/resources/application.properties

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 </td> 
 <td> <pre>&nbsp;</pre> 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.hikari.auto-commit=true spring.datasource.hikari.connection-test-query=SELECT 1 spring.datasource.hikari.maximum-pool-size=150 </td> 
 </tr> 
 </tbody> 
</table>

\# src/main/resources/application.yml

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 8 9 10 </td> 
 <td> <pre>&nbsp;</pre> spring: datasource: url: jdbc:mysql://127.0.0.1/spring_boot_testing_storage username: root password: root driver-class-name: com.mysql.jdbc.Driver hikari: auto-commit: true connection-test-query: 'SELECT 1' maximum-pool-size: 150 </td> 
 </tr> 
 </tbody> 
</table>

Spring Boot Data Jpa 依赖声明：

\# pom.xml

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 </td> 
 <td> <pre>&nbsp;</pre> &lt;dependency&gt; &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt; &lt;artifactId&gt;spring-boot-starter-data-jpa&lt;/artifactId&gt; &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;/dependency&gt; &lt;dependency&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; &lt;/dependency&gt; </td> 
 </tr> 
 </tbody> 
</table>

### DBCP 连接池 ###

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

<table> 
 <tbody> 
 <tr> 
 <th>属性</th> 
 <th>描述</th> 
 <th>默认值</th> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td>url</td> 
 <td>数据库连接地址</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>username</td> 
 <td>数据库账户</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>password</td> 
 <td>数据库密码</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>driverClassName</td> 
 <td>驱动类的名称</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>defaultAutoCommit</td> 
 <td>连接池中创建的连接默认是否自动提交事务</td> 
 <td>驱动的缺省值</td> 
 </tr> 
 <tr> 
 <td>defaultReadOnly</td> 
 <td>连接池中创建的连接默认是否为只读状态</td> 
 <td>驱动的缺省值</td> 
 </tr> 
 <tr> 
 <td>defaultCatalog</td> 
 <td>连接池中创建的连接默认的 catalog</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>initialSize</td> 
 <td>连接池启动时创建的初始连接数量</td> 
 <td>0</td> 
 </tr> 
 <tr> 
 <td>maxTotal</td> 
 <td>连接池同一时间可分配的最大活跃连接数；负数表示不限制</td> 
 <td>8</td> 
 </tr> 
 <tr> 
 <td>maxIdle</td> 
 <td>可以在池中保持空闲的最大连接数，超出此值的空闲连接被释放，负数表示不限制</td> 
 <td>8</td> 
 </tr> 
 <tr> 
 <td>minIdle</td> 
 <td>可以在池中保持空闲的最小连接数，低于此值将创建空闲连接，若设置为 0，则不创建</td> 
 <td>0</td> 
 </tr> 
 <tr> 
 <td>maxWaitMillis</td> 
 <td>最大等待时间（毫秒），如果在没有连接可用的情况下等待超过此时间，则抛出异常；-1 表示无限期等待，直到获取到连接为止</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>validationQuery</td> 
 <td>在连接池返回连接给调用者前用来对连接进行验证的查询 SQL</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>validationQueryTimeout</td> 
 <td>SQL 查询验证超时时间（秒）</td> 
 <td>-</td> 
 </tr> 
 <tr> 
 <td>testOnCreate</td> 
 <td>连接在创建之后是否进行验证</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>testOnBorrow</td> 
 <td>当从连接池中取出一个连接时是否进行验证，若验证失败则从池中删除该连接并尝试取出另一个连接</td> 
 <td>true</td> 
 </tr> 
 <tr> 
 <td>testOnReturn</td> 
 <td>当一个连接使用完归还到连接池时是否进行验证</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>testWhileIdle</td> 
 <td>对池中空闲的连接是否进行验证，验证失败则释放此连接</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>timeBetweenEvictionRunsMillis</td> 
 <td>在空闲连接回收器线程运行期间休眠时间（毫秒），如果设置为非正数，则不运行此线程</td> 
 <td>-1</td> 
 </tr> 
 <tr> 
 <td>numTestsPerEvictionRun</td> 
 <td>空闲连接回收器线程运行期间检查连接的个数</td> 
 <td>3</td> 
 </tr> 
 <tr> 
 <td>minEvictableIdleTimeMillis</td> 
 <td>连接在池中保持空闲而不被回收的最小时间（毫秒）</td> 
 <td>1800000（30分钟）</td> 
 </tr> 
 <tr> 
 <td>removeAbandonedOnBorrow</td> 
 <td>标记是否删除泄露的连接，如果连接超出removeAbandonedTimeout的限制，且该属性设置为 true，则连接被认为是被泄露并且可以被删除</td> 
 <td>false</td> 
 </tr> 
 <tr> 
 <td>removeAbandonedTimeout</td> 
 <td>泄露的连接可以被删除的超时时间（秒），该值应设置为应用程序查询可能执行的最长时间</td> 
 <td>300（5分钟）</td> 
 </tr> 
 <tr> 
 <td>poolPreparedStatements</td> 
 <td>设置该连接池的预处理语句池是否生效</td> 
 <td>false</td> 
 </tr> 
 </tbody> 
</table>

\# src/main/resources/application.properties

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 </td> 
 <td> <pre>&nbsp;</pre> spring.jmx.enabled=false 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.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 </td> 
 </tr> 
 </tbody> 
</table>

\# src/main/resources/application.yml

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 </td> 
 <td> <pre>&nbsp;</pre> spring: jmx: enabled: false datasource: url: jdbc:mysql://127.0.0.1/spring_boot_testing_storage username: root password: root driver-class-name: com.mysql.jdbc.Driver dbcp2: default-auto-commit: true initial-size: 30 max-total: 120 max-idle: 120 min-idle: 30 max-wait-millis: 10000 validation-query: 'SELECT 1' validation-query-timeout: 3 test-on-borrow: true test-while-idle: true time-between-eviction-runs-millis: 10000 num-tests-per-eviction-run: 10 min-evictable-idle-time-millis: 120000 remove-abandoned-on-borrow: true remove-abandoned-timeout: 120 pool-prepared-statements: true </td> 
 </tr> 
 </tbody> 
</table>

Spring Boot Data Jpa 依赖声明：

\# pom.xml

<table> 
 <tbody> 
 <tr> 
 <td> <pre>&nbsp;</pre> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 </td> 
 <td> <pre>&nbsp;</pre> &lt;dependency&gt; &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt; &lt;artifactId&gt;spring-boot-starter-data-jpa&lt;/artifactId&gt; &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;/dependency&gt; &lt;dependency&gt; &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; &lt;/dependency&gt; </td> 
 </tr> 
 </tbody> 
</table>

> 参考文档文献链接：[tomcat-8-jdbc-pool-doc][]、[HikariCP-doc][]、[commons-dbcp-doc][]

[Spring Boot][]

### PS ###

#### PS1: ####

还有一篇文章提到了 jdbc-interceptors : [Spring Boot JDBC 连接数据库][Spring Boot JDBC]

PS2:

这篇文章讲了tomcat的jdbc连接池: [Tomcat 的 JDBC 连接池][Tomcat _ JDBC]

转载于:https://my.oschina.net/CasparLi/blog/1510487

[2019_Python_]: https://my.oschina.net/u/2663968/blog/3061697
[hot3.png]: /images/20220114/c3d22362b8704d9c8afa622b4b223dbf.png
[tomcat-8-jdbc-pool-doc]: http://tomcat.apache.org/tomcat-8.0-doc/jdbc-pool.html#Common_Attributes
[HikariCP-doc]: https://github.com/brettwooldridge/HikariCP#configuration-knobs-baby
[commons-dbcp-doc]: http://commons.apache.org/proper/commons-dbcp/configuration.html
[Spring Boot]: http://fanlychie.github.io/tags/Spring-Boot/
[Spring Boot JDBC]: http://blog.csdn.net/catoop/article/details/50507516
[Tomcat _ JDBC]: http://wiki.jikexueyuan.com/project/tomcat/tomcat-jdbc-pool.html