1. 项目概述Spring Boot与Druid的监控整合方案在Java企业级应用开发中数据源管理是系统稳定性的命脉所在。Druid作为阿里巴巴开源的数据库连接池不仅提供了高性能的连接池功能更内置了强大的SQL监控和统计能力。而Spring Boot作为当下最流行的Java应用框架其自动化配置特性与Druid的结合可以让我们用最简洁的配置实现最全面的数据源监控。我最近在电商系统的性能调优中就遇到了SQL执行效率低下的问题。通过整合Druid监控我们成功定位到了N1查询问题将订单查询接口的响应时间从800ms降低到了200ms以内。这种整合方案特别适合以下场景需要实时掌握SQL执行情况的中大型应用面临数据库性能瓶颈需要定位慢查询的系统对数据源健康状态有严格监控要求的金融类应用2. 环境准备与基础整合2.1 依赖配置关键点在pom.xml中添加依赖时需要注意版本兼容性问题。以下是经过生产验证的稳定版本组合dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.16/version /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-jdbc/artifactId /dependency重要提示避免直接使用druid核心依赖而不用starter否则需要手动配置大量Bean。starter已经帮我们封装了90%的常用配置。2.2 基础配置的陷阱与解决方案在application.yml中以下配置项最容易出错spring: datasource: type: com.alibaba.druid.pool.DruidDataSource druid: url: jdbc:mysql://localhost:3306/demo?useSSLfalse username: root password: 123456 initial-size: 5 min-idle: 5 max-active: 20 max-wait: 60000常见问题1连接池参数配置不生效 解决方法所有Druid专属参数必须放在spring.datasource.druid节点下不能直接放在spring.datasource层级。常见问题2监控页面无法访问 解决方法必须同时配置web-stat-filter和stat-view-servlet下文会详细说明。3. 监控功能深度配置3.1 监控控制台的正确打开方式很多开发者配置完发现监控页面报403这是因为安全策略没配置好。完整的监控配置应该包括spring: datasource: druid: stat-view-servlet: enabled: true url-pattern: /druid/* login-username: admin login-password: admin123 reset-enable: false web-stat-filter: enabled: true url-pattern: /* exclusions: *.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*关键参数说明reset-enable是否允许重置统计数据生产环境建议关闭exclusions排除静态资源避免监控数据被污染login-username/password控制台登录凭证必须设置3.2 SQL监控的进阶配置要让SQL监控真正发挥作用需要配置以下关键参数spring: datasource: druid: filter: stat: enabled: true slow-sql-millis: 1000 log-slow-sql: true aop-patterns: com.example.demo.repository.*这样配置后我们可以自动记录执行超过1秒的慢查询只监控指定包下的SQL避免监控框架自身查询在控制台查看SQL执行次数、耗时分布等关键指标生产环境建议将slow-sql-millis调整为300ms这样能更快发现问题SQL。4. 多数据源场景下的监控方案4.1 多数据源配置模板对于需要连接多个数据库的系统配置示例Configuration public class DruidConfig { Bean ConfigurationProperties(spring.datasource.druid.master) public DataSource masterDataSource() { return DruidDataSourceBuilder.create().build(); } Bean ConfigurationProperties(spring.datasource.druid.slave) public DataSource slaveDataSource() { return DruidDataSourceBuilder.create().build(); } }对应的yml配置spring: datasource: druid: master: url: jdbc:mysql://master-host:3306/db username: master-user password: master-pass slave: url: jdbc:mysql://slave-host:3306/db username: slave-user password: slave-pass4.2 多数据源监控的挑战在多数据源场景下监控配置需要特别注意每个数据源需要单独配置监控过滤器控制台需要配置多个数据源的访问权限统计信息需要区分不同数据源解决方案示例Bean public ServletRegistrationBeanStatViewServlet druidServlet() { ServletRegistrationBeanStatViewServlet reg new ServletRegistrationBean(); reg.setServlet(new StatViewServlet()); reg.addUrlMappings(/druid/*); // 添加多数据源白名单 reg.addInitParameter(allow, master-host,slave-host); return reg; }5. 生产环境最佳实践5.1 安全加固方案监控页面暴露在公网非常危险必须做好以下防护修改默认访问路径不要用/druid配置强密码并定期更换限制访问IP范围启用HTTPS加密spring: datasource: druid: stat-view-servlet: url-pattern: /internal-monitor/* allow: 192.168.1.100, 10.0.0.1 deny: 0.0.0.05.2 监控数据持久化默认情况下监控数据是内存存储重启会丢失。可以通过以下方式持久化配置stat.log-slow-sql保存慢查询日志集成Prometheus实现指标收集定期将统计数据导出到数据库Bean public DruidStatInterceptor druidStatInterceptor() { return new DruidStatInterceptor(); } Bean DependsOn(druidStatInterceptor) public Advisor druidStatAdvisor() { return new RegexpMethodPointcutAdvisor( .*, druidStatInterceptor()); }6. 常见问题排查指南6.1 监控页面无法访问问题现象访问/druid返回404或403 排查步骤检查stat-view-servlet.enabled是否为true确认url-pattern配置正确检查登录凭证是否设置查看应用日志是否有安全拦截6.2 SQL监控不生效问题现象控制台看不到SQL统计 解决方案确认filter.stat.enabledtrue检查aop-patterns是否包含你的DAO层包名尝试添加filter配置类Bean public FilterRegistrationBeanWebStatFilter webStatFilter() { FilterRegistrationBeanWebStatFilter bean new FilterRegistrationBean(); bean.setFilter(new WebStatFilter()); bean.addUrlPatterns(/*); bean.addInitParameter(exclusions, *.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*); return bean; }6.3 连接泄漏检测Druid提供了强大的连接泄漏检测功能spring: datasource: druid: remove-abandoned: true remove-abandoned-timeout: 300 log-abandoned: true当连接获取后超过300秒未关闭Druid会回收该连接打印警告日志在监控页面显示泄漏统计7. 监控指标深度解析Druid监控页面包含大量有价值的数据关键指标解读数据源活跃连接数、池中连接数、最大连接数SQL监控执行次数TOP 20执行时间分布最慢SQL排行URI监控接口调用统计Session监控用户会话信息Spring监控需额外配置方法调用统计配置Spring监控的方法Bean public ServletRegistrationBeanStatViewServlet druidServlet() { ServletRegistrationBeanStatViewServlet reg new ServletRegistrationBean(); reg.setServlet(new StatViewServlet()); reg.addUrlMappings(/druid/*); // 启用Spring监控 reg.addInitParameter(spring.datasource.druid.stat.enable, true); return reg; }8. 与Prometheus集成方案对于使用K8s部署的环境可以集成Prometheus实现集群级监控添加Micrometer依赖dependency groupIdio.micrometer/groupId artifactIdmicrometer-registry-prometheus/artifactId /dependency配置暴露Druid指标Bean public DruidStatViewServletRegistrationBean druidStatViewServlet() { return new DruidStatViewServletRegistrationBean( new StatViewServlet(), /druid/*); } Bean public DruidWebStatFilterRegistrationBean druidWebStatFilter() { DruidWebStatFilterRegistrationBean bean new DruidWebStatFilterRegistrationBean(new WebStatFilter()); bean.setUrlPatterns(Collections.singletonList(/*)); return bean; }Prometheus配置示例scrape_configs: - job_name: spring-boot metrics_path: /actuator/prometheus static_configs: - targets: [host:8080]9. 性能调优实战案例在某电商项目中我们通过Druid监控发现了如下问题并优化问题1商品详情页SQL执行次数过多现象每次请求执行15次相似查询解决方案启用二级缓存SQL次数降为3次问题2订单列表页存在慢查询现象某个联表查询平均耗时1.2秒优化添加联合索引耗时降至200ms问题3凌晨批量任务连接泄漏现象连接数持续增长不释放解决配置remove-abandoned相关参数关键优化参数示例spring: datasource: druid: # 连接池优化 max-active: 50 min-idle: 10 max-wait: 5000 # 监控优化 filter: stat: merge-sql: true # 合并相似SQL slow-sql-millis: 50010. 扩展功能开发10.1 自定义监控指标继承Druid的StatLogger接口可以实现自定义日志public class CustomStatLogger implements StatLogger { Override public void log(String message) { // 写入ELK等日志系统 LogUtils.monitorLog(message); } } Bean public CustomStatLogger customStatLogger() { return new CustomStatLogger(); }10.2 告警功能集成通过定时读取Druid的JSON接口实现告警Scheduled(fixedRate 60000) public void checkDataSource() { String url http://localhost:8080/druid/datasource.json; String json restTemplate.getForObject(url, String.class); JsonNode node mapper.readTree(json); int activeCount node.get(ActiveCount).asInt(); if (activeCount 30) { alertService.send(数据源活跃连接过多 activeCount); } }在实际项目中我们基于这套监控方案构建了完整的数据库健康度评估体系包括连接池健康评分SQL性能评分慢查询自动分析容量预测模型这些扩展功能让Druid从单纯的监控工具升级成了智能的数据库运维助手。