Spring Boot 3 + Druid 【问题记录】

819 阅读3分钟

最近一个项目,希望集成 druid 来做一些监控,没想这种按步操作的事情还碰到了一些坑,遂记录一下。

版本对应

先说一下版本问题,如果你以前项目用的是 spring boot 2,现在用了 spring boot 3,那依赖包要换一下。

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

注意: 包名不一样了,spring boot 2 对应的是druid-spring-boot-starter ,而 spring boot 3 对应的是 druid-spring-boot-3-starter

配置 application.yml

spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource # 这一行就是将连接池换成 druid
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    username: xxxxxx
    password: xxxxxxxxxxxxxxxxx

如果你 druid 相关配置全用默认,那仅仅像上面的配置一样,换一下连接池就行了。对于 druid 相关的配置,详细可以看官网

下面给出一些常用配置的解释,druid 下的配置项就是:

spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource # 这一行就是将连接池换成 druid
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    username: xxxxxx
    password: xxxxxxxxxxxxxxxxx
    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检测连接是否有效,开启会降低性能,默认为true
      test-on-borrow: false
      # 归还连接时会执行validationQuery检测连接是否有效,开启会降低性能,默认为true
      test-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占用内存过多的问题,可以把这个数值配置大一些,比如说100
      max-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=5000
      web-stat-filter:
        # 是否启用StatFilter默认值true
        enabled: true
        # 添加过滤规则
        url-pattern: /*
        # 忽略过滤的格式
        exclusions: /druid/*,*.js,*.gif,*.jpg,*.png,*.css,*.ico
      stat-view-servlet:
        # 是否启用StatViewServlet默认值true
        enabled: true
        # 访问路径为/druid时,跳转到StatViewServlet
        url-pattern: /druid/*
        # 是否能够重置数据
        reset-enable: false
        # 需要账号密码才能访问控制台,默认为root,最好复杂一点,免得被人猜出来。
        login-username: xxxxxxxxx
        login-password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

监控页面访问 404

虽然是个小问题,却困扰了我很长时间。网上搜和GPT的答案都是访问 http://{ip}:{port}/druid/index.html 就行了。其实没有说清楚,我这个项目是配了上下文的,也就是说上下文并不是/ ,配置如下:

server:
  port: 6543
  servlet:
    context-path: /qingdu-server # 重点是这里

那其实我的访问路径应该是 http://localhost:6543/qingdu-server/druid/index.html