SpringBoot整合Druid并列出参数清单的代码步骤

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 连接池的核心参数全部列出来了，包括每个参数的含义、默认值以及推荐配置，在实际项目中可以直接参考。

3. 监控页面（Druid Console）访问

项目启动后，在浏览器访问下面的地址，就能进入 Druid 的监控控制台。

http://localhost:你的端口/druid/login.html

登录时使用配置文件中设置的 login-username 和 login-password，进去之后就能看到 SQL 执行情况、连接池状态、URI 监控等关键信息，非常直观。

4. 常见问题（避坑点）

1. filters 配置的插件必须存在类路径。比如配置了 log4j2，项目中就必须引入 spring-boot-starter-log4j2 依赖，否则启动会报错。
2. 如果使用了 spring.datasource.druid 前缀，就不要再配置 spring.datasource 下的 hikari 参数了，两者会冲突，导致连接池行为异常。
3. 生产环境下，建议开启 test-while-idle + validation-query 来确保连接的有效性。但不要把 test-on-borrow 设为 true，因为每次获取连接时都验证一次，对响应时间的影响比较大。