alibaba /druid
阿里云计算平台DataWorks(https://help.aliyun.com/document_detail/137663.html) 团队出品,为监控而生的数据库连接池
★ 28,141⑂ 8,541👁 1,672⑃ 2,076● 4,618▤ 52
-2
Daily
-14
Weekly
-24
Monthly
28,141
stars
8,541
forks
1,672
watchers
2,076
prs
4,618
issues
52
releases
README
Alibaba Druid
English | 中文
---
Druid 是阿里巴巴开源的高性能数据库连接池和 SQL 解析器。它将 JDBC 连接池、SQL 解析分析、安全防护和监控统计深度整合为一体,是 Java 生态中功能最全面的数据库中间件之一。
核心特性
| 功能领域 | 说明 |
|---------|------|
| JDBC 连接池 | 高性能、可监控的连接池实现 DruidDataSource,支持物理连接预热、PSCache、KeepAlive 等高级特性 |
| SQL 解析器 | 支持 30 种 SQL 方言的完整解析器,生成 AST 抽象语法树,支持 SQL 格式化、改写和分析 |
| SQL 防火墙 | 基于 AST 的 WallFilter SQL 安全防护,可拦截 SQL 注入、危险操作等 |
| 监控统计 | 内置 StatFilter 实时采集 SQL 执行统计、连接池状态,提供 Web 监控页面 |
| Filter 扩展 | 可插拔的 Filter-Chain 架构,支持日志、加密、统计等扩展 |
| Spring Boot 集成 | 提供 Spring Boot 2.x / 3.x / 4.x Starter,开箱即用 |
| 高可用 | HighAvailableDataSource 支持多数据源负载均衡、健康检查和故障切换 |
快速开始
Maven 依赖
xml
com.alibaba
druid
1.2.24
Spring Boot 项目(推荐)
根据 Spring Boot 版本选择对应 Starter:
| Spring Boot 版本 | Starter |
|-----------------|---------|
| 2.x | druid-spring-boot-starter |
| 3.x | druid-spring-boot-3-starter |
| 4.x | druid-spring-boot-4-starter |
xml
com.alibaba
druid-spring-boot-3-starter
1.2.24
yaml
application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/mydb
username: root
password: password
druid:
initial-size: 5
max-active: 20
min-idle: 5
max-wait: 60000
启用 Filter
filter:
stat:
enabled: true
log-slow-sql: true
slow-sql-millis: 2000
wall:
enabled: true
直接使用 DruidDataSource
java
DruidDataSource dataSource = new DruidDataSource();
dataSource.setUrl("jdbc:mysql://localhost:3306/mydb");
dataSource.setUsername("root");
dataSource.setPassword("password");
dataSource.setInitialSize(5);
dataSource.setMaxActive(20);
dataSource.setMinIdle(5);
dataSource.init();
// 使用连接
try (Connection conn = dataSource.getConnection()) {
// 执行 SQL
}
SQL 解析器
java
// 解析 SQL
String sql = "SELECT id, name FROM users WHERE age 18 ORDER BY name";
List stmts = SQLUtils.parseStatements(sql, DbType.mysql);
// 格式化 SQL
String formatted = SQLUtils.format(sql, DbType.mysql);
// 获取表信息
SchemaStatVisitor visitor = SQLUtils.createSchemaStatVisitor(DbType.mysql);
stmts.get(0).accept(visitor);
System.out.println("Tables: " + visitor.getTables());
System.out.println("Columns: " + visitor.getColumns());
项目模块
druid/
├── core/ 核心库(连接池、SQL 解析、安全、监控)
├── druid-spring-boot-starter/ Spring Boot 2.x 自动配置
├── druid-spring-boot-3-starter/ Spring Boot 3.x 自动配置
├── druid-spring-boot-4-starter/ Spring Boot 4.x 自动配置
├── druid-wrapper/ 包装工具
├── druid-admin/ 集群监控管理端
└── doc/ 文档
SQL 方言支持
Druid SQL 解析器支持 30 种数据库方言,每种方言都提供完整的 Lexer、Parser、AST 和 Visitor 实现:
| 分类 | 支持的数据库 |
|------|------------|
| 主流关系型 | MySQL, PostgreSQL, Oracle, SQL Server, DB2, H2, Informix |
| 国产数据库 | 达梦 (DM), Oscar, GaussDB |
| 分析型/MPP | ClickHouse, Doris, StarRocks, Teradata, Redshift |
| 云原生Top issues
#6566支持springboot4.0.0的版本什么时候会发布?34 comments · 2025-12-04#2594连接池占用大量活跃连接,不释放。27 comments · 2018-05-25#54921%概率出现GetConnectionTimeoutException: wait millis 5000, active 0, maxActive 60, creating 124 comments · 2023-11-20#5549No operations allowed after statement closed.22 comments · 2023-12-04#2103could not retrieve transaction read-only status server22 comments · 2017-11-09#2394SQL监控无数据--DataSource注入问题导致21 comments · 2018-03-09#5889CommunicationsException: The last packet successfully received from the server was 901,702 milliseconds ago. The last packet sent successfully to the server was 901,705 milliseconds ago.19 comments · 2024-05-06#2299druid分布式事物mysql8小时 超时无法使用19 comments · 2018-01-30
Latest release
DRUID 1.2.28 Release 1.2.28 2026-03-10DRUID 1.2.28发布
这是支持Spring Boot 4.x的版本,同时修复了一些SQL Parser的Bug,提升了性能,大家按需升级。
ISSUES
1. 支持Spring Boot 4.x 6536
2. 修复removeCount计算bug,连接可能同时满足evictCount和keepAliveCount的计算条件导致重复计算
3. 修复issue6318,该问题导致误判连接池空闲连接不足,创建多余连接
4. 修复SQL Server collation支持 6437
5. 修复Redshift parser中SORTKEY语法问题 6586
6. 修复SQLParserFeature未正确传递给Spark, ClickHouse和StarRocks statement parsers 6580
7. 修复GROUP BY子句带注释时换行格式问题
8. 修复DialectFeature加载性能问题和Dialect初始化性能问题
9. 修复LexerloadKeywords性能问题
10. 修复SQLDialect性能问题
11. 优化DialectFeature构造 6530
12. 支持D