Druid连接池版本升级指南：从1.0到1.2.x迁移要点

你是否在项目中遇到过数据库连接池性能瓶颈？还在为版本升级后的兼容性问题烦恼？本文将系统梳理Druid连接池从1.0到1.2.x版本的核心变化，帮助你快速掌握迁移要点，解决连接管理难题。读完本文，你将了解版本差异、关键配置变更、API调整及最佳实践，顺利完成升级。

版本概述与核心差异

当前最新稳定版本为1.2.28，定义在core/src/main/java/com/alibaba/druid/VERSION.java中：

public final class VERSION {
    public static final int MajorVersion = 1;
    public static final int MinorVersion = 2;
    public static final int RevisionVersion = 28;
}

1.2.x版本相比1.0系列主要提升：

• 连接池性能优化，吞吐量提升30%+
• 新增多数据源高可用支持doc/ha-datasource.md
• 完善监控统计功能core/src/main/java/com/alibaba/druid/stat/
• 增强SQL防火墙core/src/main/java/com/alibaba/druid/wall/

关键配置变更

已废弃配置项

废弃配置	替代方案	影响范围
maxIdle	minIdle + maxActive	所有1.0.x用户
initialSize	自动计算	连接初始化策略调整
timeBetweenLogStatsMillis	stat-logger-interval	监控统计日志

注意：maxIdle在1.2.x中已彻底移除，设置会触发core/src/main/java/com/alibaba/druid/pool/DruidAbstractDataSource.java中的错误日志：LOG.error("maxIdle is deprecated");

Spring Boot Starter变化

Spring Boot自动配置类druid-spring-boot-starter/src/main/java/com/alibaba/druid/spring/boot/autoconfigure/DruidDataSourceBuilder.java中明确标注：

* fixed, the method will be removed in future versions.

建议使用新的构建方式：

@Bean
public DataSource dataSource() {
    return DruidDataSourceBuilder.create()
        .configure(configuration)
        .build();
}

API重大调整

监控统计API变更

旧版DruidStatManagerFacade中的部分方法已标记为 deprecated：

@deprecated
public List<JdbcDataSourceStat> getDataSourceStatList() { ... }

替代方案：使用core/src/main/java/com/alibaba/druid/stat/JdbcStatManager.java提供的新接口：

List<JdbcDataSourceStat> stats = JdbcStatManager.getInstance().getDataSourceStats();

连接池状态管理

JdbcSqlStat类新增removed状态标记core/src/main/java/com/alibaba/druid/stat/JdbcSqlStat.java：

private boolean removed;
public boolean isRemoved() { return removed; }

用于标记已下线的SQL统计信息，迁移时需注意状态判断逻辑。

升级步骤与最佳实践

1. 依赖更新

Maven项目修改pom.xml：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.2.28</version>
</dependency>

2. 配置迁移

推荐配置模板：

# 基础配置
spring.datasource.druid.url=jdbc:mysql://localhost:3306/db
spring.datasource.druid.username=root
spring.datasource.druid.password=password

# 连接池配置
spring.datasource.druid.initial-size=5
spring.datasource.druid.min-idle=5
spring.datasource.druid.max-active=20

# 监控配置
spring.datasource.druid.stat-view-servlet.enabled=true
spring.datasource.druid.stat-view-servlet.url-pattern=/druid/*

3. 多数据源高可用配置

新增的HA功能doc/ha-datasource.md支持故障自动切换，配置示例：

DruidDataSource haDataSource = new DruidDataSource();
haDataSource.setUrl("jdbc:ha:mysql://master,slave1,slave2/db");
haDataSource.setUsername("root");
haDataSource.setPassword("password");

4. 测试验证

• 执行core/src/test/java/com/alibaba/druid/pool/oracle/OracleDeprecated.java中的兼容性测试
• 检查应用启动日志，确保无deprecated警告
• 通过监控页面验证统计数据是否正常采集

常见问题解决方案

问题1：启动时报maxIdle警告

原因：使用了已废弃的maxIdle配置
解决：删除maxIdle配置，调整minIdle和maxActive

问题2：Spring Boot自动配置失败

原因：旧版构建方法已移除
解决：使用DruidDataSourceBuilder.create().build()替代

问题3：监控数据为空

原因：统计过滤器未启用
解决：添加配置：

spring.datasource.druid.filters=stat,wall

迁移工具与资源

• 官方迁移文档doc/ha-datasource.md
• 版本变更记录CHANGELOG
• 示例项目druid-demo-petclinic/提供完整的1.2.x配置参考

总结与展望

Druid 1.2.x系列带来了显著的性能提升和功能增强，尤其是在高可用和监控方面。迁移过程中需重点关注配置项清理、API更新和依赖调整。建议采用渐进式迁移策略：

1. 先升级依赖版本，解决编译错误
2. 移除废弃配置，替换为新API
3. 启用新特性，如多数据源HA和增强监控
4. 全面测试验证性能和稳定性

通过本文指南，相信你已掌握Druid连接池升级的核心要点。如有更多疑问，可参考项目官方文档或提交issue获取支持。