alibaba /druid

阿里云计算平台DataWorks(https://help.aliyun.com/document_detail/137663.html) 团队出品,为监控而生的数据库连接池

★ 28,141⑂ 8,541👁 1,672⑃ 2,076● 4,618▤ 52
JavaApache-2.0Created 2011-11-03github.com/alibaba/druid/wiki
下载: DRUID 1.2.28 Releasedruid-1.2.28 ↓1.2.282026-03-10
-2
日增长
-14
周增长
-24
月增长
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

Latest release

DRUID 1.2.28 Release 1.2.28 2026-03-10
DRUID 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON