阿里Druid数据源：DruidDataSource配置属性全解

1. 前言

Druid是Java语言中最好的数据库连接池。Druid能够提供强大的监控和扩展功能。

Druid是一个开源项目，源码托管在github上，源代码仓库地址是：
 https://github.com/alibaba/druid

同时每次Druid发布正式版本和快照的时候，都会把源码打包，你可以从上面的下载地址中找到相关版本的源码

DruidDataSource配置兼容DBCP，但个别配置的语意有所区别。 以下配置说明基于druid 1.2.22 整理，请升级至1.2.22或更高版本，并参考以下属性进行相关配置

2. 配置项说明

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

3.DruidDataSource 参考配置

3.1 通用配置

DruidDataSource大部分属性都是参考DBCP的，如果你原来就是使用DBCP，迁移是十分方便的。

 <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> 
     <property name="url" value="${jdbc_url}" />
     <property name="username" value="${jdbc_user}" />
     <property name="password" value="${jdbc_password}" />

     <property name="filters" value="stat" />

     <property name="maxActive" value="20" />
     <property name="initialSize" value="1" />
     <property name="maxWait" value="6000" />
     <property name="minIdle" value="1" />

     <property name="timeBetweenEvictionRunsMillis" value="60000" />
     <property name="minEvictableIdleTimeMillis" value="300000" />

     <property name="testWhileIdle" value="true" />
     <property name="testOnBorrow" value="false" />
     <property name="testOnReturn" value="false" />

     <property name="poolPreparedStatements" value="true" />
     <property name="maxOpenPreparedStatements" value="20" />

     <property name="asyncInit" value="true" />
 </bean>

注释：

• 在上面的配置中，通常你需要配置url、username、password，maxActive这四项。
• Druid会自动跟url识别驱动类名，如果连接的数据库非常见数据库，配置属性driverClassName
• asyncInit是1.1.4中新增加的配置，如果有initialSize数量较多时，打开会加快应用启动时间

3.2 连接阿里云AnalyticDB参考配置

使用Druid连接池连接阿里云AnalyticDB 建议配置keepAlive=true ，并使用1.1.16 之后的版本

  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> 
     <!-- 基本属性 url、user、password -->
     <property name="url" value="${jdbc_url}" />
     <property name="username" value="${jdbc_user}" />
     <property name="password" value="${jdbc_password}" />
       
     <!-- 配置初始化大小、最小、最大 -->
     <property name="initialSize" value="5" />
     <property name="minIdle" value="10" /> 
     <property name="maxActive" value="20" />
  
     <!-- 配置获取连接等待超时的时间 -->
     <property name="maxWait" value="6000" />
  
     <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->
     <property name="timeBetweenEvictionRunsMillis" value="2000" />
  
     <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->
     <property name="minEvictableIdleTimeMillis" value="600000" />
     <property name="maxEvictableIdleTimeMillis" value="900000" />
   
     <property name="validationQuery" value="select 1" />
     <property name="testWhileIdle" value="true" />
     <property name="testOnBorrow" value="false" />
     <property name="testOnReturn" value="false" />
  
     <property name="keepAlive" value="true" />
     <property name="phyMaxUseCount" value="1000" />
  
     <!-- 配置监控统计拦截的filters -->
     <property name="filters" value="stat" /> 
 </bean>

3.3 连接阿里云Data Lake Analytics参考配置

使用Druid连接池连接阿里云Data Lake Analytics 建议配置keepAlive=true，并使用1.1.16 之后的版本

  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> 
     <!-- 基本属性 url、user、password -->
     <property name="url" value="${jdbc_url}" />
     <property name="username" value="${jdbc_user}" />
     <property name="password" value="${jdbc_password}" />
       
     <!-- 配置初始化大小、最小、最大 -->
     <property name="initialSize" value="1" />
     <property name="minIdle" value="1" /> 
     <property name="maxActive" value="10" />
  
     <!-- 配置获取连接等待超时的时间 -->
     <property name="maxWait" value="6000" />
  
     <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->
     <property name="timeBetweenEvictionRunsMillis" value="2000" />
  
     <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->
     <property name="minEvictableIdleTimeMillis" value="600000" />
     <property name="maxEvictableIdleTimeMillis" value="900000" />
   
     <property name="validationQuery" value="select 1" />
     <property name="testWhileIdle" value="true" />
     <property name="testOnBorrow" value="false" />
     <property name="testOnReturn" value="false" />
  
     <property name="keepAlive" value="true" />
     <property name="phyMaxUseCount" value="500" />
  
     <!-- 配置监控统计拦截的filters -->
     <property name="filters" value="stat" /> 
 </bean>

4. Druid锁的公平模式问题

锁的公平和效率是一个需要平衡的问题。

如果配置了maxWait，在连接不够用争用时，unfair模式的ReentrantLock.tryLock方法存在严重不公的现象，个别线程会等到超时了还获取不到连接。

版本	处理方式	效果
0.2.3之前	unfair	并发性能很好。 maxWait>0的配置下，出现严重不公平现象
0.2.3 ~ 0.2.6	fair	公平，但是并发性能很差
0.2.7	通过构造函数传入参数指定fair或者unfair，缺省fair	按需要配置，但是比较麻烦
0.2.8	缺省unfair，通过构造函数传入参数指定fair或者unfair； 如果DruidDataSource还没有初始化，修改maxWait大于0，自动转换为fair模式	智能配置，能够兼顾性能和公平性

可以手工配置

dataSouce.setUseUnfairLock(true)