Spring Boot--Druid连接池的配置方法

悠悠 2023-09-29 17:14 12阅读 0赞

原文网址：[Spring Boot--Druid连接池的配置方法\_IT利刃出鞘的博客-CSDN博客][Spring Boot--Druid_IT_-CSDN]

## 简介 ##

**说明**

本文介绍Spring Boot的Druid连接池的配置方法。

Druid 是阿里巴巴开源的一个数据库连接池实现，结合了 C3P0、DBCP、PROXOOL 等 DB 池的优点，同时加入了日志监控。Druid支持的监控功能有：统计SQL信息、SQL性能收集、SQL注入检查、SQL翻译等。

**官网网址**

Druid的github（有解析）：[https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter][https_github.com_alibaba_druid_tree_master_druid-spring-boot-starter]

配置文档：[DruidDataSource配置属性列表 · alibaba/druid Wiki · GitHub][DruidDataSource_ _ alibaba_druid Wiki _ GitHub]

## 配置概述 ##

在Spring Boot自动化配置中，对于数据源的配置可以分为两类：

**通用配置**

以spring.datasource.\*的形式存在，主要是配置一些常规内容。比如：数据库链接地址、用户名、密码等。这里就不做过多说明了，通常就这些配置：

spring:
      datasource:
        driver-class-name: com.mysql.jdbc.Driver
        url: jdbc:mysql://127.0.0.1:3306/test
        username: root
        password: 222333

**数据源连接池配置**

以spring.datasource.<数据源名称>.\*的形式存在，比如：Druid的配置参数就是spring.datasource.druid.\*形式。下面这个是我们最常用的几个配置项：

spring:
      datasource:
        druid:
          initial-size: 10
          min-idle: 10
          maxActive: 200
          maxWait: 60000
          timeBetweenEvictionRunsMillis: 60000
          minEvictableIdleTimeMillis: 300000
          validationQuery: SELECT 1 FROM DUAL
          testWhileIdle: true
          testOnBorrow: false
          testOnReturn: false
          poolPreparedStatements: true
          maxPoolPreparedStatementPerConnectionSize: 20
          connectionErrorRetryAttempts: 3
          breakAfterAcquireFailure: true
          timeBetweenConnectErrorMillis: 300000
          asyncInit: true
          remove-abandoned: true
          remove-abandoned-timeout: 1800
          transaction-query-timeout: 6000
          filters: stat,wall,log4j2
          connectionProperties: druid.stat.mergeSql\=true;druid.stat.slowSqlMillis\=5000
          web-stat-filter:
            enabled: true
            url-pattern: "/*"
            exclusions: "*.js,*.gif,*.jpg,*.bmp,*.png,*.css,*.ico,/druid/*"
          stat-view-servlet:
            url-pattern: "/druid/*"
            allow:
            deny:
            reset-enable: false
            login-username: admin
            login-password: admin

## 配置示例 ##

下边是推荐使用的配置

## 配置详解 ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:160px;"> 配置 </td> 
 <td style="width:318px;"> 缺省值 </td> 
 <td style="width:321.3pt;"> 说明 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> name </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 配置这个属性的意义在于，如果存在多个数据源，监控的时候可以通过名字来区分开来。如果没有配置，将会生成一个名字，格式是："DataSource-" + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的，强行设置name会出错。<a href="http://blog.csdn.net/lanmo555/article/details/41248763" title="详情-点此处" rel="nofollow">详情-点此处</a>。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> url </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 连接数据库的url，不同数据库不一样。例如： mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> username </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 连接数据库的用户名 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> password </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 连接数据库的密码。如果你不希望密码直接写在配置文件中，可以使用ConfigFilter。<a href="https://github.com/alibaba/druid/wiki/%E4%BD%BF%E7%94%A8ConfigFilter" title="详细看这里" rel="nofollow">详细看这里</a> </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> driverClassName </td> 
 <td style="width:318px;"> 根据url自动识别 </td> 
 <td style="width:321.3pt;"> 这一项可配可不配，如果不配置druid会根据url自动识别dbType，然后选择相应的driverClassName </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> initialSize </td> 
 <td style="width:318px;"> 0 </td> 
 <td style="width:321.3pt;"> 初始化时建立物理连接的个数。初始化发生在显示调用init方法，或者第一次getConnection时 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> maxActive </td> 
 <td style="width:318px;"> 8 </td> 
 <td style="width:321.3pt;"> 最大连接池数量 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> maxIdle </td> 
 <td style="width:318px;"> 8 </td> 
 <td style="width:321.3pt;"> 已经不再使用，配置了也没效果 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> minIdle </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 最小连接池数量 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> maxWait </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 获取连接时最大等待时间，单位毫秒。配置了maxWait之后，缺省启用公平锁，并发效率会有所下降，如果需要可以通过配置useUnfairLock属性为true使用非公平锁。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> poolPreparedStatements </td> 
 <td style="width:318px;"> false </td> 
 <td style="width:321.3pt;"> 是否缓存preparedStatement，也就是PSCache。PSCache对支持游标的数据库性能提升巨大，比如说oracle。在mysql下建议关闭。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> maxPoolPreparedStatementPerConnectionSize </td> 
 <td style="width:318px;"> -1 </td> 
 <td style="width:321.3pt;"> 要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> validationQuery </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 用来检测连接是否有效的sql，要求是一个查询语句，常用select 'x'。如果validationQuery为null，testOnBorrow、testOnReturn、testWhileIdle都不会起作用。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> validationQueryTimeout </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 单位：秒，检测连接是否有效的超时时间。底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> testOnBorrow </td> 
 <td style="width:318px;"> true </td> 
 <td style="width:321.3pt;"> 申请连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> testOnReturn </td> 
 <td style="width:318px;"> false </td> 
 <td style="width:321.3pt;"> 归还连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> testWhileIdle </td> 
 <td style="width:318px;"> false </td> 
 <td style="width:321.3pt;"> 建议配置为true，不影响性能，并且保证安全性。申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> keepAlive </td> 
 <td style="width:318px;"> false （1.0.28） </td> 
 <td style="width:321.3pt;"> 连接池中的minIdle数量以内的连接，空闲时间超过minEvictableIdleTimeMillis，则会执行keepAlive操作。 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> timeBetweenEvictionRunsMillis </td> 
 <td style="width:318px;"> 1分钟（1.0.14） </td> 
 <td style="width:321.3pt;"> 有两个含义： 1) Destroy线程会检测连接的间隔时间，如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。 2) testWhileIdle的判断依据，详细看testWhileIdle属性的说明 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> numTestsPerEvictionRun </td> 
 <td style="width:318px;"> 30分钟（1.0.14） </td> 
 <td style="width:321.3pt;"> 不再使用，一个DruidDataSource只支持一个EvictionRun </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> minEvictableIdleTimeMillis </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 连接保持空闲而不被驱逐的最小时间 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> connectionInitSqls </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 物理连接初始化的时候执行的sql </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> exceptionSorter </td> 
 <td style="width:318px;"> 根据dbType自动识别 </td> 
 <td style="width:321.3pt;"> 当数据库抛出一些不可恢复的异常时，抛弃连接 </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> filters </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有： 监控统计用的filter:stat 日志用的filter:log4j 防御sql注入的filter:wall </td> 
 </tr> 
 <tr> 
 <td style="width:160px;"> proxyFilters </td> 
 <td style="width:318px;"> </td> 
 <td style="width:321.3pt;"> 类型是List&lt;com.alibaba.druid.filter.Filter&gt;，如果同时配置了filters和proxyFilters，是组合关系，并非替换关系 </td> 
 </tr> 
 </tbody> 
</table>

[Spring Boot--Druid_IT_-CSDN]: https://knife.blog.csdn.net/article/details/126833904
[https_github.com_alibaba_druid_tree_master_druid-spring-boot-starter]: https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter
[DruidDataSource_ _ alibaba_druid Wiki _ GitHub]: https://github.com/alibaba/druid/wiki/DruidDataSource%E9%85%8D%E7%BD%AE%E5%B1%9E%E6%80%A7%E5%88%97%E8%A1%A8