1. 整合步骤（基于 Spring Boot 官方 Starter）
在 Spring Boot 项目中整合 Druid 连接池，官方推荐的方案是直接使用其专属 Starter 组件。这样一来，大量重复性配置工作可以被有效简化，你只需专注于核心参数调优即可。以下是完整的整合操作流程。
第一步：引入 Ma ven 依赖
在项目 pom.xml 文件中添加以下依赖项，建议选用最新稳定版本，例如 1.2.20，以确保功能与安全性。
com.alibaba druid-spring-boot-starter 1.2.20
第二步：在application.yml中配置数据源和连接池参数
依赖引入完成后，接下来需要在 application.yml 中配置数据源基本信息以及 Druid 连接池专属参数，两者缺一不可。下面给出了一份可直接用于生产环境的配置示例。
spring:
datasource:
# 基本连接信息（必须）
url: jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
# 指定使用 Druid 数据源（必须）
type: com.alibaba.druid.pool.DruidDataSource
# Druid 连接池专属参数（核心清单见下文）
druid:
# 初始连接数
initial-size: 5
# 最小空闲连接数
min-idle: 5
# 最大活跃连接数
max-active: 20
# 获取连接超时时间（毫秒）
max-wait: 60000
# 连接保持空闲而不被回收的最小时间（毫秒）
time-between-eviction-runs-millis: 60000
# 连接在池中最小生存时间（毫秒）
min-evictable-idle-time-millis: 300000
# 验证连接是否有效的 SQL（MySQL 使用）
validation-query: SELECT 1 FROM DUAL
# 验证超时时间（秒）
validation-query-timeout: 3
# 申请连接时执行 validation-query 检测
test-on-borrow: false
# 归还连接时执行 validation-query 检测
test-on-return: false
# 空闲时检测连接有效性（建议开启）
test-while-idle: true
# 监控统计 + 日志 + 防御 SQL 注入（配置三个插件）
filters: stat,log4j2,wall
# StatFilter 监控配置
stat:
log-slow-sql: true
slow-sql-millis: 2000
merge-sql: true
# WallFilter（SQL 防火墙）配置
wall:
config:
delete-where-none-check: true
# 监控页面（Druid Console）访问配置
stat-view-servlet:
enabled: true
url-pattern: /druid/*
login-username: admin
login-password: admin123
reset-enable: false
# Web 应用监控（URI 统计）
web-stat-filter:
enabled: true
url-pattern: /*
exclusions: '*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*'
2. Druid 连接池完整核心参数清单
下面这张表格完整罗列了 Druid 连接池的核心参数，涵盖了参数含义、默认取值以及推荐配置，在实际项目开发与调优过程中可以直接参考使用。
| 参数名 | 说明 | 默认值 | 推荐值（示例） |
|---|---|---|---|
initial-size | 初始化时创建的连接数 | 0 | 5~10 |
min-idle | 最小空闲连接数 | 0 | 5~10 |
max-active | 最大活跃连接数（最大并发数） | 8 | 20~100（视业务） |
max-wait | 获取连接最大等待时间（毫秒），超时抛异常 | -1（无限） | 60000 |
time-between-eviction-runs-millis | 空闲连接检查/回收的间隔（毫秒） | 60000（1分钟） | 60000 |
min-evictable-idle-time-millis | 连接最小空闲时间，超过则被回收（毫秒） | 1800000（30分钟） | 300000（5分钟） |
max-evictable-idle-time-millis | 连接最大空闲时间，强制回收（毫秒） | 25200000（7小时） | - |
validation-query | 验证连接有效性的 SQL（必须支持快速执行） | null | MySQL: SELECT 1 / Oracle: SELECT 1 FROM DUAL |
validation-query-timeout | 验证 SQL 执行超时时间（秒） | -1 | 3 |
test-on-borrow | 获取连接时立即执行验证（影响性能） | false | false |
test-on-return | 归还连接时执行验证（影响性能） | false | false |
test-while-idle | 空闲时检测连接有效性（强烈建议开启） | false | true |
pool-prepared-statements | 是否缓存 PreparedStatement（PSCache） | false | true（开启可提升性能） |
max-pool-prepared-statement-per-connection-size | 每个连接缓存的 PreparedStatement 上限 | -1 | 20 |
filters | 扩展插件（用逗号分隔）：stat（监控）, wall（防火墙）, log4j2（日志） | - | stat,wall,log4j2 |
connection-properties | 自定义连接属性，如 config.decrypt=true（密码解密） | - | - |
use-global-data-source-stat | 是否开启全局数据源统计 | false | - |
3. 监控页面（Druid Console）访问
应用启动成功后，在浏览器中访问以下地址即可进入 Druid 内置的监控控制台，实时查看连接池与 SQL 执行状况。
https://localhost:你的端口/druid/login.html
登录时使用配置文件中设定的 login-username 和 login-password，认证通过后即可直观地查看 SQL 执行明细、连接池实时状态、URI 访问统计等关键监控数据，便于日常运维与性能分析。
4. 常见问题（避坑点）
filters配置的插件必须存在类路径。例如配置了log4j2，项目中就必须引入spring-boot-starter-log4j2依赖，否则启动时将因缺失类而报错。- 如果使用了
spring.datasource.druid前缀，就不要再配置spring.datasource下的 hikari 参数了，两者会产生冲突，导致连接池行为异常，无法按预期工作。 - 生产环境下，建议开启
test-while-idle结合validation-query来确保连接的有效性。但不要将test-on-borrow设为true，因为每次获取连接时都执行验证会对响应时间造成较大影响，降低系统吞吐量。
