spring boot 切换 druid 连接池需禁用 hikari 自动配置、复用通用 datasource 配置并补充 druid 专属参数，同时启用连接泄漏检测、监控端点及避免多数据源 bean 冲突。

Spring Boot 默认用 HikariCP，但很多团队更倾向 Druid——它监控能力强、SQL 防御机制完善、连接泄漏检测更细。切换本身不难，关键在“优雅”：不破坏原有配置习惯、不引发自动装配冲突、不遗漏连接池特有参数。

替换依赖并关闭默认装配

Druid 通过 starter 自动注册自己的 DataSource Bean，但 Spring Boot 的自动配置会抢先加载 Hikari。所以第一步是让 Hikari 的自动配置失效：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 引入 druid-spring-boot-starter（Spring Boot 2.x）或 druid-spring-boot-3-starter（Spring Boot 3.x+）
• 在 application.yml 中显式禁用 Hikari 自动配置：
  spring:
    autoconfigure:
      exclude: com.zaxxer.hikari.HikariConfig

复用原有数据库配置，只补 Druid 特有项

Spring Boot 的 spring.datasource.* 基础配置（url、username、driver-class-name 等）对所有连接池通用，无需重写。你只需追加 Druid 专属配置段：

• 指定类型：type: com.alibaba.druid.pool.DruidDataSource
• 在 druid: 下配置连接池行为，比如：
  — initial-size、max-active、min-idle
  — time-between-eviction-runs-millis（注意带 -millis 后缀，缺了会静默失效）
  — filters: stat,wall,log4j2 开启监控与 SQL 防御

避免常见陷阱

切换后容易出问题的点集中在三处：

• 连接泄漏未感知：Druid 默认不开启 remove-abandoned-on-borrow，建议加上 remove-abandoned-on-borrow: true 和 remove-abandoned-timeout: 1800
• 监控端点未暴露：需手动启用 Druid 内置控制台，如配置 web-stat-filter.enabled: true 和 stat-view-servlet.enabled: true
• 多数据源场景下 Bean 冲突：若项目已用 @Primary 标注主数据源，确保 Druid 的 DataSource Bean 名称与配置类中 @Bean 方法名一致，且不与其他自定义 DataSource 重名

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南