当前位置：首页 > news >正文

在Spring Boot 3.3中使用Druid数据源及其监控功能

news 来源：原创 2025/6/6 17:30:18

在这里插入图片描述

在Spring Boot 3.3中使用Druid数据源及其监控功能

在Spring Boot项目中，数据源是与数据库进行交互的核心组件。默认情况下，Spring Boot 3.3使用HikariCP作为数据源，但有时我们可能需要更强大的功能，比如SQL监控、慢SQL记录和详细的连接池管理。这时，Druid是一个非常合适的选择。Druid是阿里巴巴开源的一个功能强大的数据库连接池，它不仅提供了高效的连接管理，还支持丰富的监控功能。

1. Druid数据源与Spring Boot默认数据源的关系

Spring Boot默认使用HikariCP作为数据源，它是一个高性能的数据库连接池。然而，Druid提供了更多的功能，比如SQL监控、慢SQL记录和详细的连接池管理。通过在Spring Boot项目中引入Druid，可以替换默认的HikariCP数据源。

以下是Druid数据源与Spring Boot默认数据源的关系以及相关类的类图：

DataSource 是一个接口，定义了 getConnection() 和 close() 方法。
HikariDataSource 和 DruidDataSource 都实现了 DataSource 接口。
DataSourceProperties 用于配置数据源的属性，可以通过 initializeDataSourceBuilder() 方法初始化 HikariDataSource 或 DruidDataSource。
DruidStatProperties 用于配置 Druid 的监控功能，包括 StatViewServlet 和 WebStatFilter。

2. 添加依赖

在pom.xml中添加以下依赖：

<dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-3-starter</artifactId><version>1.2.20</version>
</dependency>

3. 配置Druid数据源

在application.yml文件中，配置Druid数据源的基本信息和连接池参数：

spring:application:name: spring-boot-demodatasource:url: jdbc:mysql://localhost:3306/db_spring_boot_demo?useSSL=false&serverTimezone=UTCusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Drivertype: com.alibaba.druid.pool.DruidDataSourcedruid:initial-size: 5min-idle: 5max-active: 20max-wait: 60000test-while-idle: truetime-between-eviction-runs-millis: 60000min-evictable-idle-time-millis: 30000validation-query: select 'x'test-on-borrow: falsetest-on-return: falsepool-prepared-statements: falsefilters: stat,wall,slf4jmax-pool-prepared-statement-per-connection-size: -1use-global-data-source-stat: trueconnect-properties: druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000

4. 配置Druid监控功能

在application.yml中，配置Druid的监控功能，包括StatViewServlet和WebStatFilter：

spring:datasource:druid:web-stat-filter:enabled: trueurl-pattern: /*exclusions: /druid/*,*.js,*.gif,*.jpg,*.png,*.css,*.icostat-view-servlet:enabled: trueurl-pattern: /druid/*reset-enable: falselogin-username: adminlogin-password: adminallow: 127.0.0.1deny:

完整的配置如下：

spring:application:name:  spring-boot-demodatasource:url: jdbc:mysql://localhost:3306/db_spring_boot_demo?useSSL=false&serverTimezone=UTCusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Driver# druid-spring-boot-starter 依赖自动生效 druid，可以不配置 type 属性，但建议配置type: com.alibaba.druid.pool.DruidDataSource# druid 连接池管理druid:# 初始化时建立物理连接的个数initial-size: 5# 连接池的最小空闲数量min-idle: 5# 连接池最大连接数量max-active: 20# 获取连接时最大等待时间，单位毫秒max-wait: 60000# 申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。test-while-idle: true# 既作为检测的间隔时间又作为testWhileIdel执行的依据time-between-eviction-runs-millis: 60000# 销毁线程时检测当前连接的最后活动时间和当前时间差大于该值时，关闭当前连接(配置连接在池中的最小生存时间)min-evictable-idle-time-millis: 30000# 用来检测数据库连接是否有效的sql 必须是一个查询语句(oracle中为 select 1 from dual)validation-query: select 'x'# 申请连接时会执行validationQuery检测连接是否有效,开启会降低性能,默认为truetest-on-borrow: false# 归还连接时会执行validationQuery检测连接是否有效,开启会降低性能,默认为truetest-on-return: false# 是否缓存preparedStatement, 也就是PSCache,PSCache对支持游标的数据库性能提升巨大，比如说oracle,在mysql下建议关闭。pool-prepared-statements: false# 置监控统计拦截的filters，去掉后监控界面sql无法统计，stat: 监控统计、Slf4j:日志记录、waLL: 防御sqL注入filters: stat,wall,slf4j# 要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100max-pool-prepared-statement-per-connection-size: -1# 合并多个DruidDataSource的监控数据use-global-data-source-stat: true# 通过connectProperties属性来打开mergeSql功能；慢SQL记录connect-properties: druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000web-stat-filter:# 是否启用StatFilter默认值trueenabled: true# 添加过滤规则url-pattern: /*# 忽略过滤的格式exclusions: /druid/*,*.js,*.gif,*.jpg,*.png,*.css,*.icostat-view-servlet:# 是否启用StatViewServlet默认值trueenabled: true# 访问路径为/druid时，跳转到StatViewServleturl-pattern: /druid/*# 是否能够重置数据reset-enable: false# 需要账号密码才能访问控制台，默认为rootlogin-username: adminlogin-password: admin# IP白名单allow: 127.0.0.1# IP黑名单（共同存在时，deny优先于allow）deny:

5. 启动项目并访问监控页面

启动Spring Boot项目后，访问http://localhost:8080/druid，使用用户名admin和密码admin登录。登录后，你将看到Druid监控页面，其中包含了以下功能：
在这里插入图片描述

5.1 SQL监控

在监控页面中，点击“SQL监控”选项卡，可以查看所有执行的SQL语句及其详细信息。这对于优化SQL性能非常有帮助。
在这里插入图片描述

5.2 慢SQL记录

通过配置druid.stat.slowSqlMillis=5000，Druid会记录执行时间超过5秒的SQL语句。这些慢SQL语句可以在监控页面中查看，帮助开发者快速定位性能瓶颈。

5.3 数据库连接池监控

Druid提供了详细的连接池监控信息，包括：

活跃连接数：当前正在使用的连接数。
空闲连接数：当前未使用的连接数。
等待连接数：等待获取连接的线程数。
最大连接数：连接池允许的最大连接数。

这些信息可以帮助开发者合理配置连接池参数，优化数据库连接的使用效率。

6. 注意事项

6.1 依赖版本

确保使用与Spring Boot 3.3兼容的Druid版本。如果使用了不兼容的版本，可能会导致配置无法生效或出现其他问题。

6.2 安全性

在生产环境中，建议对数据库密码进行加密，并限制Druid监控页面的访问权限，以防止敏感信息泄露。可以通过配置allow和deny属性来限制访问IP。

6.3 Spring Security配置

如果你的项目中使用了Spring Security，可能需要为Druid监控页面配置访问权限。例如：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {@Overrideprotected void configure(HttpSecurity http) throws Exception {http.authorizeRequests().antMatchers("/druid/**").permitAll() // 允许访问Druid监控页面.anyRequest().authenticated().and().formLogin().and().csrf().disable();}
}