脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → SpringBoot整合Druid列出参数清单

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

 更新时间：2026年07月30日 08:59:11   作者：Full Stack Developme  
本文详细讲解如何在SpringBoot项目中整合Druid连接池,包括Maven依赖引入、yml配置示例、核心参数如max-active、validation-query的推荐值,以及如何访问监控页面查看SQL执行和连接池状态,同时总结了filters配置冲突、连接有效性验证等常见避坑点

1. 整合步骤（基于 Spring Boot 官方 Starter）

第一步：引入 Maven 依赖

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.20</version> <!-- 建议使用最新稳定版 -->
</dependency>

第二步：在application.yml中配置数据源和连接池参数

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 连接池完整核心参数清单

参数名说明默认值推荐值（示例）
initial-size初始化时创建的连接数05~10
min-idle最小空闲连接数05~10
max-active最大活跃连接数（最大并发数）820~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（必须支持快速执行）nullMySQL: SELECT 1 / Oracle: SELECT 1 FROM DUAL
validation-query-timeout验证 SQL 执行超时时间（秒）-13
test-on-borrow获取连接时立即执行验证（影响性能）falsefalse
test-on-return归还连接时执行验证（影响性能）falsefalse
test-while-idle空闲时检测连接有效性（强烈建议开启）falsetrue
pool-prepared-statements是否缓存 PreparedStatement（PSCache）falsetrue（开启可提升性能）
max-pool-prepared-statement-per-connection-size每个连接缓存的 PreparedStatement 上限-120
filters扩展插件（用逗号分隔）：stat（监控）, wall（防火墙）, log4j2（日志）-stat,wall,log4j2
connection-properties自定义连接属性，如 config.decrypt=true（密码解密）--
use-global-data-source-stat是否开启全局数据源统计false-

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

启动项目后，访问：

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 以免影响响应时间。

以上就是SpringBoot整合Druid并列出参数清单的代码步骤的详细内容，更多关于SpringBoot整合Druid列出参数清单的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

相关文章

最新评论