快捷導航

Spring Boot 整合 Druid 并開啟監(jiān)控

更新時間：2026年05月21日 09:43:48 作者：qiumingxun

本文主要介紹了在SpringBoot中集成Druid數(shù)據(jù)庫連接池并啟用監(jiān)控功能的步驟,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

Druid 是一個由阿里巴巴開源的高性能數(shù)據(jù)庫連接池，它不僅提供了高效的連接管理功能，還自帶了強大的監(jiān)控和統(tǒng)計特性。將 Druid 與 Spring Boot 結(jié)合使用，可以顯著提高應(yīng)用程序的數(shù)據(jù)訪問性能，并且通過內(nèi)置的監(jiān)控頁面，開發(fā)者能夠?qū)崟r監(jiān)控數(shù)據(jù)庫連接的狀態(tài)、SQL 執(zhí)行情況等重要信息。

1. 引言

隨著互聯(lián)網(wǎng)應(yīng)用的快速發(fā)展，對數(shù)據(jù)庫連接池的要求也越來越高。傳統(tǒng)的連接池可能無法滿足現(xiàn)代應(yīng)用對于高性能和高可用性的需求。而 Druid 憑借其優(yōu)秀的性能優(yōu)化、詳細的監(jiān)控數(shù)據(jù)以及靈活的配置選項，成為了許多開發(fā)者的首選。接下來，我們將一步步展示如何在 Spring Boot 中引入 Druid，并啟用它的監(jiān)控功能。

2. 添加依賴

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

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

如果你使用的是 Gradle 構(gòu)建工具，則可以在 build.gradle 文件中添加如下內(nèi)容：

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

3. 配置數(shù)據(jù)源

接下來，在 application.properties 或 application.yml 文件中配置 Druid 數(shù)據(jù)源的相關(guān)參數(shù)。這里以 .properties 文件為例：

# Druid 數(shù)據(jù)源配置
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
# 監(jiān)控頁面設(shè)置
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

上述配置項包括了連接池的基本參數(shù)（如初始大小、最小空閑連接數(shù)、最大活動連接數(shù)等），同時也啟用了 Druid 的 Web 統(tǒng)計過濾器和統(tǒng)計視圖 Servlet，并設(shè)置了登錄用戶名和密碼用于訪問監(jiān)控頁面。

4. 開啟監(jiān)控功能

為了更好地管理和監(jiān)控 Druid 連接池的工作狀態(tài)，我們需要開啟 Druid 提供的監(jiān)控功能。這可以通過配置文件中的幾個關(guān)鍵屬性來實現(xiàn)：

WebStatFilter：用于收集 Web 應(yīng)用程序的 SQL 慢查詢?nèi)罩尽?/li>
StatViewServlet：提供了一個可視化的監(jiān)控頁面，可以查看連接池的各項指標。

確保在 application.properties 或 application.yml 中啟用了這兩個組件：

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

此外，還可以進一步自定義監(jiān)控頁面的安全策略，比如允許或限制特定 IP 地址訪問、設(shè)置更多的登錄憑證等。

5. 自定義 Druid 配置（可選）

如果默認配置不能滿足你的需求，你可以創(chuàng)建一個自定義的 Druid 配置類來覆蓋默認設(shè)置。例如：

@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;
    }
}

6. 訪問監(jiān)控頁面

完成上述配置后，啟動 Spring Boot 應(yīng)用程序，然后打開瀏覽器并訪問以下 URL 來查看 Druid 的監(jiān)控頁面：

http://localhost:8080/druid/

使用之前設(shè)置的用戶名和密碼登錄后，你將看到一個包含詳細連接池信息和 SQL 查詢統(tǒng)計的界面。通過這個頁面，你可以輕松地監(jiān)控數(shù)據(jù)庫連接的狀態(tài)、分析 SQL 性能瓶頸等問題。

7. 注意事項

生產(chǎn)環(huán)境安全：在生產(chǎn)環(huán)境中部署時，請務(wù)必加強對監(jiān)控頁面的訪問控制，避免敏感信息泄露。
性能影響：雖然 Druid 的監(jiān)控功能非常有用，但在高并發(fā)場景下可能會對系統(tǒng)性能產(chǎn)生一定影響。因此，在實際應(yīng)用中應(yīng)權(quán)衡利弊，合理配置監(jiān)控級別。
更新維護：定期檢查 Druid 版本更新，及時修復已知漏洞和問題，保持系統(tǒng)的穩(wěn)定性和安全性。