Spring Boot 整合 Druid 并开启监控

最新推荐文章于 2025-11-23 13:27:25 发布

原创最新推荐文章于 2025-11-23 13:27:25 发布 · 887 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #后端 #java

面试同时被 3 个专栏收录

65 篇文章

订阅专栏

学习路线

65 篇文章

订阅专栏

阿里巴巴

65 篇文章

订阅专栏

文章目录

1. 引言
2. 添加依赖
3. 配置数据源
4. 开启监控功能
5. 自定义 Druid 配置（可选）
6. 访问监控页面
7. 注意事项
8. 总结

Druid 是一个由阿里巴巴开源的高性能数据库连接池，它不仅提供了高效的连接管理功能，还自带了强大的监控和统计特性。将 Druid 与 Spring Boot 结合使用，可以显著提高应用程序的数据访问性能，并且通过内置的监控页面，开发者能够实时监控数据库连接的状态、SQL 执行情况等重要信息。

1. 引言

随着互联网应用的快速发展，对数据库连接池的要求也越来越高。传统的连接池可能无法满足现代应用对于高性能和高可用性的需求。而 Druid 凭借其优秀的性能优化、详细的监控数据以及灵活的配置选项，成为了许多开发者的首选。接下来，我们将一步步展示如何在 Spring Boot 中引入 Druid，并启用它的监控功能。

2. 添加依赖

首先，在你的 pom.xml 文件中添加 Druid 的 Maven 依赖：

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

如果你使用的是 Gradle 构建工具，则可以在 build.gradle 文件中添加如下内容：

implementation 'com.alibaba:druid-spring-boot-3-starter:1.2.24'

3. 配置数据源

接下来，在 application.properties 或 application.yml 文件中配置 Druid 数据源的相关参数。这里以 .properties 文件为例：

# Druid 数据源配置
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
spring.datasource.druid.initial-size=5
spring.datasource.druid.min-idle=5
spring.datasource.druid.max-active=20
spring.datasource.druid.test-on-borrow=true
spring.datasource.druid.validation-query=SELECT 1 FROM DUAL

# 监控页面设置
spring.datasource.druid.web-stat-filter.enabled=true
spring.datasource.druid.stat-view-servlet.enabled=true
spring.datasource.druid.stat-view-servlet.login-username=druid
spring.datasource.druid.stat-view-servlet.login-password=d1234

yaml示例：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/test?characterEncoding=utf8&useSSL=false
    username: root
    password: 1234
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      test-on-borrow: true
      validation-query: SELECT 1 FROM DUAL
      web-stat-filter:
        enabled: true
      stat-view-servlet:
        enabled: true
        login-username: druid
        login-password: d1234

上述配置项包括了连接池的基本参数（如初始大小、最小空闲连接数、最大活动连接数等），同时也启用了 Druid 的 Web 统计过滤器和统计视图 Servlet，并设置了登录用户名和密码用于访问监控页面。

4. 开启监控功能

为了更好地管理和监控 Druid 连接池的工作状态，我们需要开启 Druid 提供的监控功能。这可以通过配置文件中的几个关键属性来实现：

WebStatFilter：用于收集 Web 应用程序的 SQL 慢查询日志。
StatViewServlet：提供了一个可视化的监控页面，可以查看连接池的各项指标。

确保在 application.properties 或 application.yml 中启用了这两个组件：

# 启用 WebStatFilter 和 StatViewServlet
spring.datasource.druid.web-stat-filter.enabled=true
spring.datasource.druid.stat-view-servlet.enabled=true

此外，还可以进一步自定义监控页面的安全策略，比如允许或限制特定 IP 地址访问、设置更多的登录凭证等。

5. 自定义 Druid 配置（可选）

如果默认配置不能满足你的需求，你可以创建一个自定义的 Druid 配置类来覆盖默认设置。例如：

@Configuration
public class DruidConfig {

    @ConfigurationProperties(prefix = "spring.datasource.druid")
    @Bean
    public DruidDataSource druidDataSource() {
        return new DruidDataSource();
    }

    // 如果需要，可以在这里添加更多配置，如过滤器、拦截器等
    @Bean
    public ServletRegistrationBean<StatViewServlet> statViewServlet() {
        ServletRegistrationBean<StatViewServlet> bean = new ServletRegistrationBean<>(new StatViewServlet(), "/druid/*");
        Map<String, String> params = new HashMap<>();
        params.put("loginUsername", username);
        params.put("loginPassword", password);
        params.put("allow", "localhost");
        params.put("deny", "");
        bean.setInitParameters(params);
        return bean;
    }

    @Bean
    public FilterRegistrationBean<Filter> webStatFilter() {
        FilterRegistrationBean<Filter> bean = new FilterRegistrationBean<Filter>();
        bean.setFilter(new WebStatFilter());
        Map<String, String> params = new HashMap<>();
        params.put("exclusions", "*.js,*.css,/druid/*");
        bean.setUrlPatterns(Arrays.asList("/*"));
        bean.setInitParameters(params);
        return bean;
    }
}