Appearance
Druid 常见问题及解答
1. Druid 是什么？
Druid 是 Java 语言中最好的数据库连接池。Druid 能够提供强大的监控和扩展功能。
2. 在哪里下载 druid
正式版本下载：
3. 怎么获取 Druid 的源码
Druid 是一个开源项目，源码托管在 github 上，源代码仓库地址是 https://github.com/alibaba/druid 。同时每次 Druid 发布正式版本和快照的时候，都会把源码打包，你可以从上面的下载地址中找到相关版本的源码
4. 怎么配置 maven
Druid 0.1.18 之后版本都发布到 maven 中央仓库中，所以你只需要在项目的 pom.xml 中加上 dependency 就可以了。例如：
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid-version}</version>
</dependency>也可以选择 Maven 仓库查找公共的仓库地址: http://www.mvnrepository.com/artifact/com.alibaba/druid
5. 怎么打开 Druid 的监控统计功能
Druid 的监控统计功能是通过 filter-chain 扩展实现，如果你要打开监控统计功能，配置 StatFilter，具体看这里：https://github.com/alibaba/druid/wiki/配置_StatFilter
6. 怎样使用 Druid 的内置监控页面
内置监控页面是一个 Servlet，具体配置看这里： https://github.com/alibaba/druid/wiki/配置_StatViewServlet配置
7. 内置监控中的 Web 和 Spring 关联监控怎么配置？
- Web关联监控配置 https://github.com/alibaba/druid/wiki/配置_配置WebStatFilter
- Spring关联监控配置 https://github.com/alibaba/druid/wiki/配置_Druid和Spring关联监控配置
8. 怎么配置防御 SQL 注入攻击
Druid 提供了 WallFilter，它是基于 SQL 语义分析来实现防御 SQL 注入攻击的。具体配置看这里： https://github.com/alibaba/druid/wiki/配置-wallfilter
9. Druid 有没有参考配置
不同的业务场景需求不同，你可以使用我们的参考配置，但建议你仔细阅读相关文档，了解清楚之后做定制配置。 https://github.com/alibaba/druid/wiki/配置_DruidDataSource参考配置
10. 我想日志记录 JDBC 执行的 SQL，如何配置
Druid 提供了 Log4jFilter、CommonsLogFilter和Slf4jFilter，具体配置看这里 https://github.com/alibaba/druid/wiki/配置_LogFilter
11. 我的程序可能产生连接泄漏了，有什么办法？
Druid 提供了多种监测连接泄漏的手段，具体看这里： https://github.com/alibaba/druid/wiki/连接泄漏监测
12. 在 Druid 中使用 PSCache 会有内存占用过大问题么？
连接 Oracle 数据库，打开 PSCache，在其他的数据库连接池都会存在内存占用过多的问题，Druid 是唯一解决这个问题的连接池。具体看这里： https://github.com/alibaba/druid/wiki/Oracle数据库下PreparedStatementCache内存问题解决方案
13. 有没有和其他数据库连接池的对比？
14. 从其他连接池迁移要注意什么？
- 不同连接池的参数参照对比： http://code.alibabatech.com/wiki/pages/viewpage.action?pageId=6947005
- DBCP迁移 https://github.com/alibaba/druid/wiki/DBCP迁移
15. Druid 中有没有类似 Jboss DataSource 中的 ExceptionSorter
ExceptionSorter 是 JBoss DataSource 中的优秀特性，Druid 也有一样功能的 ExceptionSorter，但不用手动配置，自动识别生效的。具体看这里：https://github.com/alibaba/druid/wiki/ExceptionSorter_cn
16. Druid 中的 maxIdle 为什么是没用的？
maxIdle 是 Druid 为了方便 DBCP 用户迁移而增加的，maxIdle 是一个混乱的概念。连接池只应该有 maxPoolSize 和 minPoolSize，druid 只保留了 maxActive 和 minIdle，分别相当于 maxPoolSize 和 minPoolSize。
17. 我的应用配置的是 JNDI 数据源，可以用 DruidDataSource 么？
DruidDataSource 支持 JNDI 配置，具体看这里：https://github.com/alibaba/druid/wiki/配置_JNDI_Tomcat
具体实现的类是这个：com.alibaba.druid.pool.DruidDataSourceFactory，你可以阅读代码加深理解。
18. 我的应用已使用 DBCP，是代码中写死的，怎样更换为 Druid？
可以的，Druid 提供了一个中完全平滑迁移 DBCP 的办法。
- 从 http://repo1.maven.org/maven2/com/alibaba/druid/druid-wrapper/ 下载 druid-wrapper-xxx.jar
- 加入 druid-xxx.jar
- 从你的 WEB-INF/lib/ 中删除 dbcp-xxx.jar
- 按需要加上配置，比如 JVM 启动参数加上 -Ddruid.filters=stat，动态配置 druid 的 filters
这种用法，使得可以在一些非自己开发的应用中使用 Druid，例如在 sonar 中部署 druid，sonar 是一个使用 jruby 开发的 web 应用，写死了 DBCP，只能够通过这种方法来更换。
19. 我想试用快照版本，怎么获取？
直接获取快照版本的地址是： http://code.alibabatech.com/mvn/snapshots/com/alibaba/druid/ ，使用快照版本建议加入我们 QQ 群 92748305，遇到问题直接反馈给我们。
20. 有一些 SQL 执行很慢，我希望日志记录下来，怎么设置？
在 StatFilter 配置中有慢 SQL 执行日志记录，看这里 https://github.com/alibaba/druid/wiki/配置_StatFilter
21. 我希望加密我的数据库密码怎么办？
运维和 DBA 都不希望把密码明文直接写在配置文件中，Druid 提供了数据库密码加密的功能。具体看这里： https://github.com/alibaba/druid/wiki/使用ConfigFilter
22. 如何参与 Druid 的开发
Druid 是一个通过 github 开源的项目，github 的特性，使得你很容易参与其中。这里有详细说明 https://github.com/alibaba/druid/wiki/如何参与
23. Druid 的发布周期是怎样？
Druid 是一个活跃的项目，长期维护。每个月有一个发布窗口，除非遇到重大 bug 和非常紧急的需求，否则都是每个月最多发布一次。如果没有足够多的需求，发布窗口就不会被使用。
24. 如果 DruidDataSource 在 init 的时候失败了，不再使用，是否需要 close
是的，如果 DruidDataSource 不再使用，必须调用 close 来释放资源，释放的资源包括关闭 Create 和 Destory 线程。
25. DruidDataSource 支持哪些数据库？
理论上说，支持所有有 jdbc 驱动的数据库。实际测试过的有
| 数据库 | 支持状态 |
|---|---|
| mysql | 支持，大规模使用 |
| oracle | 支持，大规模使用 |
| sqlserver | 支持 |
| postgres | 支持 |
| db2 | 支持 |
| h2 | 支持 |
| derby | 支持 |
| sqlite | 支持 |
| sybase | 支持 |
26. Oracle 下 jdbc executeBatch 时，更新行数计算不正确
使用 jdbc 的 executeBatch 方法，如果数据库为 oracle，则无论是否成功更新到数据，返回值都是-2，而不是真正被 sql 更新到的记录数，这是 Oracle JDBC Driver 的问题，Druid 不作特殊处理。
27. Druid 如何自动根据 URL 自动识别 DriverClass 的
Druid 是根据 url 前缀来识别 DriverClass 的，这样使得配置更方便简洁。
| 前缀 | DriverCLass | 描述信息 |
|---|---|---|
| jdbc:odps | com.aliyun.odps.jdbc.OdpsDriver | |
| jdbc:derby | org.apache.derby.jdbc.EmbeddedDriver | |
| jdbc:mysql | com.mysql.jdbc.Driver | |
| jdbc:oracle | oracle.jdbc.driver.OracleDriver | |
| jdbc:microsoft | com.microsoft.jdbc.sqlserver.SQLServerDriver | |
| jdbc:sybase:Tds | com.sybase.jdbc2.jdbc.SybDriver | |
| jdbc:jtds | net.sourceforge.jtds.jdbc.Driver | |
| jdbc:postgresql | org.postgresql.Driver | |
| jdbc:fake | com.alibaba.druid.mock.MockDriver | |
| jdbc:mock | com.alibaba.druid.mock.MockDriver | |
| jdbc:hsqldb | org.hsqldb.jdbcDriver | |
| jdbc:db2 | COM.ibm.db2.jdbc.app.DB2Driver | DB2的JDBC Driver十分混乱，这个匹配不一定对 |
| jdbc:sqlite | org.sqlite.JDBC | |
| jdbc:ingres | com.ingres.jdbc.IngresDriver | |
| jdbc:h2 | org.h2.Driver | |
| jdbc:mckoi | com.mckoi.JDBCDriver | |
| jdbc:cloudscape | COM.cloudscape.core.JDBCDriver | |
| jdbc:informix-sqli | com.informix.jdbc.IfxDriver | |
| jdbc:timesten | com.timesten.jdbc.TimesTenDriver | |
| jdbc:as400 | com.ibm.as400.access.AS400JDBCDriver | |
| jdbc:sapdb | com.sap.dbtech.jdbc.DriverSapDB | |
| jdbc:JSQLConnect | com.jnetdirect.jsql.JSQLDriver | |
| jdbc:JTurbo | com.newatlanta.jturbo.driver.Driver | |
| jdbc:firebirdsql | org.firebirdsql.jdbc.FBDriver | |
| jdbc:interbase | interbase.interclient.Driver | |
| jdbc:pointbase | com.pointbase.jdbc.jdbcUniversalDriver | |
| jdbc:edbc | ca.edbc.jdbc.EdbcDriver | |
| jdbc:mimer:multi1 | com.mimer.jdbc.Driver |
28. 如何保存监控记录
https://github.com/alibaba/druid/wiki/怎么保存Druid的监控记录
29. 我想 Log 输出 SQL 执行的信息怎么办？
https://github.com/alibaba/druid/wiki/配置_LogFilter
30. 如何配置Druid内置的 log 实现
https://github.com/alibaba/druid/wiki/配置druid内置的log实现
31. 如何在 Spring Boot 中集成 Druid 连接池和监控？
使用Druid Spring Boot Starter，文档地址： https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter
32. 如何在 Spring Boot 中添加自定义 WallConfig、Filter ？
https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter#如何配置-filter
33. 如何在 Spring Boot 中配置数据库密码加密？
- 先看常见问题 21，如何生成加密后的密码及秘钥：https://github.com/alibaba/druid/wiki/常见问题#21-我希望加密我的数据库密码怎么办
- 进行配置
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
# 生成的加密后的密码（原密码 123456）
spring.datasource.password=WVMjPhfXQrIsWRo0/RCqAVvYtTU9WNVToKJohb8AlUmHwnV6vwFL+FM2CNFDMJwGHW1iCmyaUlF+sgvFdogqEA==
# 生成的公钥
public-key=MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAIiwHpFrDijV+GzwRTzWJk8D3j3jFfhsMFJ/7k1NTvBuLgL+TdIHgaMNOIEjHpXzuvX38J3FtOK8hLrySncVGOMCAwEAAQ==
# 配置 connection-properties，启用加密，配置公钥。
spring.datasource.druid.connection-properties=config.decrypt=true;config.decrypt.key=${public-key}
# 启用ConfigFilter
spring.datasource.druid.filter.config.enabled=true34. 如何设置为让连接池知道数据库已经断开了，并且自动测试连接查询
加入以下配置：
<!-- 用来检测连接是否有效的sql，要求是一个查询语句，常用select 'x'。如果validationQuery为null，testOnBorrow、testOnReturn、testWhileIdle都不会起作用。 -->
<property name="validationQuery" value="SELECT 1" />
<property name="testOnBorrow" value="false" />
<property name="testOnReturn" value="false" />
<property name="testWhileIdle" value="true" />出错的异常信息摘要： Could not open JDBC Connection for transaction； nested exception is ...jdbc4... No operation allowed after connection closed;