Spring Boot集成Druid连接池怎么开启监控后台_StatViewServlet与SQL防火墙配置

陌雪吖_4388

陌雪吖_4388

2026-03-18

348人浏览

原创

需手动注册StatViewServlet并配置WebStatFilter和WallFilter,确保路径匹配、Filter顺序正确、依赖完整且生产环境兼容。

spring boot集成druid连接池怎么开启监控后台_statviewservlet与sql防火墙配置

怎么配 StatViewServlet 让 Druid 监控页面跑起来

Druid 的监控后台不是默认开启的,得手动注册一个 StatViewServlet,否则访问 /druid 就是 404。Spring Boot 2.0+ 后不再自动注册这个 Servlet,必须显式配置。

常见错误是只加了依赖、配了数据源,但没注册 Servlet,结果以为“集成好了”,一试发现页面打不开。

  • 在 application.yml 里加基础配置:
    spring:
      datasource:
        druid:
          stat-view-servlet:
            enabled: true
            url-pattern: /druid/*
            login-username: admin
            login-password: admin
  • 但光这样不够 —— Spring Boot 不会自动扫描并注册 StatViewServlet,还得写 Java 配置类:
  • 新建一个 @Configuration 类,用 @Bean 注册 StatViewServlet,注意路径匹配要和 url-pattern 一致;
  • 如果用了 Spring Security,得放行 /druid/** 路径,否则登录页都加载不了(常见卡点);
  • 别把 login-username 和 login-password 硬编码在配置里,上线前务必改成环境变量或密钥管理方式。

WallFilter 开启 SQL 防火墙为什么没生效

开了 WallFilter 却照样能执行 DELETE FROM user WHERE 1=1 这类语句?大概率是没真正启用 Wall 规则,或者规则配置被绕过了。

Druid 的 SQL 防火墙不是开关一开就拦所有危险操作,它依赖两个条件:Filter 必须注册成功 + 对应数据库类型的规则文件被加载。

  • 确保 druid-wall 依赖已引入(Maven 中单独加 com.alibaba.druid:druid-wall);
  • 在 application.yml 中启用:
    spring:
      datasource:
        druid:
          wall:
            enabled: true
            config-file: classpath:wall-filter.properties
  • config-file 是可选的,但如果没指定,Druid 会按数据库类型加载默认规则(如 mysql 或 oracle),此时必须保证 spring.datasource.url 中包含正确数据库标识(比如含 mysql 字样);
  • 若自定义规则文件,内容需为 key=value 形式,例如 selectWhereAlone=false,且文件编码必须是 UTF-8(BOM 会导致解析失败);
  • 注意:WallFilter 只拦截 JDBC 层的 SQL,MyBatis 动态 SQL 若拼接在 Java 里(非 XML/注解原始 SQL),可能逃逸检测。

监控页面进得去,但 SQL 列表为空或实时数据不更新

页面能登录,但看不到慢 SQL、SQL 统计图空白、连接池状态不动 —— 多半是 WebStatFilter 没配对,或者 Filter 顺序错了。

Druid 监控依赖两个 Filter 协同:一个统计 Web 请求(WebStatFilter),一个收集 JDBC 执行(StatFilter)。缺一不可,而且 WebStatFilter 必须在 Spring MVC Filter 链前面。

  • 确认 WebStatFilter 已注册,且 url-pattern 覆盖你的真实请求路径(比如 /*,不是 /druid/*);
  • 检查是否和其他 Filter(如 Shiro、JWT、Spring Security)冲突 —— 如果 WebStatFilter 被放在它们后面,用户请求可能被提前拦截,导致统计不到;
  • 确认数据源配置中启用了 stat 类型 Filter:
    spring:
      datasource:
        druid:
          filters: stat,wall
    (不能漏掉 stat);
  • 某些场景下(如异步线程里执行 SQL),Druid 默认不追踪上下文,需要手动调用 DruidDataSource.setUseGlobalDataSourceStat(true) 并确保单例共享。

为什么本地 OK,上生产后监控页面 404 或防火墙失效

最常忽略的是 profile 差异和 jar 包冲突。开发时用 spring-boot-devtools 或 IDE 启动,很多配置隐式生效;打包成 jar 后,classloader 行为变了,资源路径、Filter 加载时机全不同。

尤其要注意 druid-spring-boot-starter 版本与 Spring Boot 主版本的兼容性 —— 1.1.x 的 starter 不支持 Boot 2.4+ 的 ServletRegistrationBean 变更,容易导致 StatViewServlet 根本没注册。

  • 检查打包后的 BOOT-INF/lib/ 下是否存在 druid-*.jar 和 druid-wall-*.jar,避免 Maven 依赖传递被 exclude 掉;
  • 确认 application-prod.yml 里没有覆盖掉 druid.stat-view-servlet.enabled=true;
  • 生产环境若用了 Nginx,确认转发时没 strip 掉 /druid/ 路径(比如配置了 rewrite ^/druid/(.*)$ /$1 break; 就会导致 404);
  • 防火墙规则在生产库名/表名敏感时,建议先用 log-violation=true 和 throw-exception=false 观察日志,而不是直接 true,避免误杀业务 SQL。

Druid 的监控和防火墙不是“配完就稳”,它的行为高度依赖 Filter 注册时机、类加载路径、数据库 URL 解析逻辑 —— 这些地方稍有偏差,表面看着启动成功,实际关键能力已经掉线。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring boot框架优点
spring boot框架优点

spring boot框架的优点有简化配置、快速开发、内嵌服务器、微服务支持、自动化测试和生态系统支持。本专题为大家提供spring boot相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

691

5

spring框架有哪些
spring框架有哪些

spring框架有Spring Core、Spring MVC、Spring Data、Spring Security、Spring AOP和Spring Boot。详细介绍:1、Spring Core,通过将对象的创建和依赖关系的管理交给容器来实现,从而降低了组件之间的耦合度;2、Spring MVC,提供基于模型-视图-控制器的架构,用于开发灵活和可扩展的Web应用程序等。

2023.10.12

1455

7

Java Spring Boot开发
Java Spring Boot开发

本专题围绕 Java 主流开发框架 Spring Boot 展开,系统讲解依赖注入、配置管理、数据访问、RESTful API、微服务架构与安全认证等核心知识,并通过电商平台、博客系统与企业管理系统等项目实战,帮助学员掌握使用 Spring Boot 快速开发高效、稳定的企业级应用。

2025.08.19

5406

10

Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性
Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性

Spring Boot 是一个基于 Spring 框架的 Java 开发框架,它通过 约定优于配置的原则,大幅简化了 Spring 应用的初始搭建、配置和开发过程,让开发者可以快速构建独立的、生产级别的 Spring 应用,无需繁琐的样板配置,通常集成嵌入式服务器(如 Tomcat),提供“开箱即用”的体验,是构建微服务和 Web 应用的流行工具。

2025.12.22

436

5

Java Spring Boot 微服务实战
Java Spring Boot 微服务实战

本专题深入讲解 Java Spring Boot 在微服务架构中的应用,内容涵盖服务注册与发现、REST API开发、配置中心、负载均衡、熔断与限流、日志与监控。通过实际项目案例(如电商订单系统),帮助开发者掌握 从单体应用迁移到高可用微服务系统的完整流程与实战能力。

2025.12.24

680

18

Spring Boot企业级开发与MyBatis Plus实战
Spring Boot企业级开发与MyBatis Plus实战

本专题面向 Java 后端开发者,系统讲解如何基于 Spring Boot 与 MyBatis Plus 构建高效、规范的企业级应用。内容涵盖项目架构设计、数据访问层封装、通用 CRUD 实现、分页与条件查询、代码生成器以及常见性能优化方案。通过完整实战案例,帮助开发者提升后端开发效率,减少重复代码,快速交付稳定可维护的业务系统。

2026.02.11

405

24

Kotlin协程编程与Spring Boot集成实践
Kotlin协程编程与Spring Boot集成实践

本专题围绕 Kotlin 协程机制展开,深入讲解挂起函数、协程作用域、结构化并发与异常处理机制,并结合 Spring Boot 展示协程在后端开发中的实际应用。内容涵盖异步接口设计、数据库调用优化、线程资源管理以及性能调优策略,帮助开发者构建更加简洁高效的 Kotlin 后端服务架构。

2026.02.12

391

18

Spring Boot 项目开发与实战
Spring Boot 项目开发与实战

以 Spring Boot 为核心,讲解项目的快速初始化(Spring Initializr)、自动配置与 Starter 依赖原理、配置文件(application.yml)多环境管理、RESTful API 接口开发与参数校验、MyBatis / MyBatis-Plus / Spring Data JPA 数据持久层整合、Redis 缓存集成、统一异常处理与全局响应封装、Swagger / Knife4j 接口文档生成,以及 Ma

2026.04.17

366

21

Java Spring Boot多租户架构设计与数据隔离实战
Java Spring Boot多租户架构设计与数据隔离实战

本专题聚焦 Java 企业级系统中的多租户架构设计,讲解数据隔离策略、租户路由机制、数据库分库分表方案以及权限控制模型。通过真实 SaaS 系统案例,帮助开发者构建可扩展的多租户应用架构。

2026.06.29

516

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习