数据库连接池Druid

---

Druid介绍

Druid 是阿里巴巴开源平台上一个数据库连接池技术，Druid连接池为监控而生，内置强大的监控功能，监控特性不影响性能。内置了StatFilter功能，能采集非常完备的连接池执行信息，Druid连接池内置了一个监控页面，提供了非常完备的监控信息，可以很好的监控DB池连接和SQL的执行情况，快速诊断系统的瓶颈。

Driud与Hikari都是当前比较主流的Java Web数据源技术。SpringBoot目前默认使用Hikari数据源，自身并未提供对Driud的集成，但阿里巴巴自己提供了Druid与SpringBoot的集成druid-spring-boot-starter。

Maven依赖

druid-spring-boot-starter依赖：

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.2.22</version>
        </dependency>

配置参数

本文的配置参数都基于1.2.22版本。

参数名称	默认值	说明
url		数据库连接 URL
username		数据库用户名
password		数据库密码
driverClassName		JDBC 驱动类名 这一项可配可不配，如果不配置druid会根据url自动识别dbType，然后选择相应的driverClassName
maxActive	8	连接池最大活跃连接数 当连接数量达到该值时，再获取新连接时，将处于等待状态，直到有连接被释放，才能借用成功
maxIdle	8	已经彻底废弃，配置了也没效果，以maxActive为准
minIdle	0	连接池最小空闲连接数
maxWait	-1	获取连接时的最大等待时间，单位毫秒，默认-1表示不限制 配置了maxWait之后，默认使用公平锁，并发效率会有所下降，如果需要可以通过配置useUnfairLock属性为true使用非公平锁。
initialSize	0	初始化时建立的连接数
maxEvictableIdleTimeMillis	25200000	连接最大空闲时间（毫秒），超过该时间的空闲连接将被移除
timeBetweenEvictionRunsMillis	60000	连接池的空闲连接检测周期，单位毫秒 有两个含义： 1. Destroy线程会检测连接的间隔时间，如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。 2. testWhileIdle的判断依据，详细看testWhileIdle属性的说明
minEvictableIdleTimeMillis	1800000	最小空闲连接存活时间，单位毫秒 空闲超过该时间的连接会被检测并关闭
testWhileIdle	true	是否在空闲时测试连接是否有效 建议配置为true，不影响性能，并且保证安全性。申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。
testOnBorrow	false	是否在申请连接时测试连接有效性 申请连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能，其实一般情况下都可以开启，只有性能要求极其高且连接使用很频繁的情况下才有必要禁用。
testOnReturn	false	是否在归还连接时测试连接有效性 归还连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能，这个一般不需要开启。
validationQuery		用来检测连接是否有效的sql，要求是一个查询语句 常用select ‘x’。如果validationQuery为null，testOnBorrow、testOnReturn、testWhileIdle都不会起作用。
validationQueryTimeout	-1	检测连接是否有效查询的超时时间，单位秒 大于0才生效。底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法
logAbandoned	false	是否输出日志，记录未关闭的连接 在开启removeAbandoned为true的情况，可以开启该设置，druid在销毁未及时关闭的连接时，则会输出日志信息，便于定位连接泄露问题
removeAbandoned	false	是否回收泄漏的连接 默认不开启，建议只在测试环境设置未开启，利用测试环境发现业务代码中未正常关闭连接的情况
removeAbandonedTimeoutMillis	300000	回收泄露连接的最大超时，默认300秒 表示连接被借出超过5分钟后，且removeAbandoned开启的情况下，强制关闭该泄露连接
keepAlive	false	是否保持连接活跃 连接池中的minIdle数量以内的连接，空闲时间超过minEvictableIdleTimeMillis，则会执行keepAlive操作。实际项目中建议配置成true
keepAliveBetweenTimeMillis	120000	保持连接活跃的时间间隔，单位毫秒
connectionProperties	{}	数据库连接的额外属性 字符串方式放入自定义的key和value，键值对用分号隔开，比如“a=b;c=d”，传入空白字符串表示清空属性，实际拆分字符串后赋值给connectProperties，在Filter等地方可以获取该信息进行相应逻辑控制
connectionInitSqls	[]	初始化数据库连接时执行的 SQL 脚本 数组方式定义物理连接初始化的时候执行的1到多条sql语句，比如连接MySQL数据库使用低版本驱动的情况下，想使用utf8mb4,则可以配置sql为： set NAMES ‘utf8mb4’
createScheduler		自定义定时线程池，用于异步创建连接 可以使用定时线程池方式异步创建连接，比起默认的单线程创建连接方式，经实际验证这种更可靠
destroyScheduler		自定义定时线程池，用于异步销毁连接 可以使用定时线程池方式异步创建连接，比起默认的单线程创建连接方式，经实际验证这种更可靠
failFast	false	是否在连接池初始化失败时立即抛出异常
dbType		强制指定数据库类型，不用Druid 自动识别的数据库类型 值来自com.alibaba.druid.DbType的枚举名
filters	-	配置 Druid 的过滤器，如监控统计（stat）、日志（log4j）、防 SQL 注入（wall）等 属性类型是逗号隔开的字符串，通过别名的方式配置扩展插件，插件别名列表请参考druid jar包中的 /META-INF/druid-filter.properties,常用的插件有： - 监控统计用的filter:stat - 日志用的filter:log4j - 防御sql注入的filter:wall - 防御sql注入的filter:wall
proxyFilters	-	自定义代理过滤器 类型是List<com.alibaba.druid.filter.Filter>，如果同时配置了filters和proxyFilters，是组合关系，并非替换关系
poolPreparedStatements	false	是否启用 PreparedStatement 缓存（PSCache） PSCache对支持游标的数据库性能提升巨大，比如说oracle。在mysql下建议关闭。
maxPoolPreparedStatementPerConnectionSize	10	每个连接上最多允许缓存的 PreparedStatement 数量 要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100
numTestsPerEvictionRun	3	已废弃，不再使用 一个DruidDataSource只支持一个EvictionRun
socketTimeout	0	新增的控制创建连接时的socket最大读超时，单位是毫秒 默认0表示永远等待，配置成10000则表示db操作如果在10秒内未返回应答，将抛出异常，工作原理是在创建连接时将该值设置到对应数据库驱动的属性信息中由其JDBC驱动进行控制
loginTimeout	-	数据库连接的登录超时时间，单位秒 底层调用DriverManager全局静态方法
queryTimeout	0	控制查询结果的最大超时，单位秒 大于0才生效，最终底层调用是java.sql.Statement.setQueryTimeout(int)
transactionQueryTimeout	0	控制事务中查询的最大超时，单位秒 于0才生效，最终是在开启事务的情况下底层调用java.sql.Statement.setQueryTimeout(int)
phyTimeoutMillis	-1	强制回收物理连接的最大超时时长，大于0的情况下才生效 当物理创建之后存活的时长超过该值时，该连接会强制销毁，便于重新创建新连接，建议可以配置成7小时的毫秒值，比如25200000，这样可以规避MySQL的8小时连接断开问题
name	DataSource-****	数据源的名称 配置这个属性的意义在于，如果存在多个数据源，监控的时候可以通过名字来区分开来。如果没有配置，将会生成一个名字，格式是：“DataSource-” + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的，强行设置name会出错。
exceptionSorter		数据库异常排序器，用于决定哪些异常需要丢弃连接 当数据库抛出一些不可恢复的异常时，抛弃连接
passwordCallback		自定义实现定制密码解密效果的回调函数 可以自定义实现定制的PasswordCallback，然后实现定制的密码解密效果

使用示例

下面举例单数据源的两种配置方式。

方式1：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/demo?useLegacyDatetimeCode=false&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&useUnicode=true&rewriteBatchedStatements=true&serverTimezone=GMT%2B8
    type: com.alibaba.druid.pool.DruidDataSource        # 可以不配置，使用druid
    driverClassName: com.mysql.cj.jdbc.Driver         	# 可以不配置，会根据url分析的到相应数据库的驱动
    username: root                                   	# 用户名
    password: 123456                                	# 密码
    druid:                              				# Druid配置
      initialSize: 5                                    # 初始化连接数
      minIdle: 5                                        # 最小连接数
      maxActive: 22                                     # 最大连接数
      maxWait: 60000                                    # 获取连接等待超时的时间
      validationQuery: SELECT 1                         # 检测连接是否有效的sql
      testWhileIdle: true                               # 申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效
      timeBetweenEvictionRunsMillis: 60000              # 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒
      minEvictableIdleTimeMillis: 300000                # 配置一个连接在池中最小生存的时间，单位是毫秒

方式2：

spring:
  datasource:
    druid:                                              # Druid配置
      url: jdbc:mysql://127.0.0.1:3306/demo?useLegacyDatetimeCode=false&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&useUnicode=true&rewriteBatchedStatements=true&serverTimezone=GMT%2B8
      driverClassName: 'com.mysql.cj.jdbc.Driver'       # 可以不配置，会根据url分析的到相应数据库的驱动
      username: root                                   	# 用户名
      password: 123456                                	# 密码
      initialSize: 5                                    # 初始化连接数
      minIdle: 5                                        # 最小连接数
      maxActive: 22                                     # 最大连接数
      maxWait: 60000                                    # 获取连接等待超时的时间
      validationQuery: SELECT 1                         # 检测连接是否有效的sql
      testWhileIdle: true                               # 申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效
      timeBetweenEvictionRunsMillis: 60000              # 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒
      minEvictableIdleTimeMillis: 300000                # 配置一个连接在池中最小生存的时间，单位是毫秒

参考文章：
DruidDataSource配置属性列表