【SpringBoot教程】SpringBoot+MySQL+Druid连接池整合教程

🙋大家好！我是毛毛张! 🌈个人首页： 神马都会亿点点的毛毛张

前面毛毛张介绍过HikariCP连接池，今天毛毛张来介绍一下Druid连接池，SpringBoot 2.0以上默认使用HikariCP数据源，但是也要学会使用Druid连接池，可以说HikariCP与Driud都是当前JavaWeb上最优秀的数据源

文章目录 1 Druid连接池简介2 入门使用教程2.1 后端代码2.1.1 创建项目2.1.2 导入依赖2.1.3 编写配置文件2.1.4 初始化数据库并创建对应实体类2.1.5 编写响应封装与前端展示VO2.1.6 编写业务逻辑2.1.7 跨域资源共享2.1.8 启动类2.1.9 测试2.1.10 Druid后台监控查看 2.2 前端代码2.3 可能会遇到的问题2.3.1 MySQL 连接器版本问题2.3.2 javax.annotation.Resource找不到包的问题2.3.3 监控页面报`404`2.3.4 之前SpringBoot3不兼容Druid - 可忽略 2.4 总结 3 配置详解3.1 导入依赖3.1.1 Druid三种依赖3.1.2 SpringBoot 2.x 依赖3.1.3 SpringBoot 3.x 依赖 3.2 常见配置3.3 数据源配置解析3.4 连接池配置详解3.5 Druid监控配置3.6 总结 4 总结参考文献

1 Druid连接池简介 Druid 是阿里巴巴开源的一款高性能数据库连接池，集成了 C3P0、DBCP 等传统连接池的优点，并针对高并发和大规模生产环境进行了优化。它提供了高效的数据库连接管理，具备强大的监控和统计功能，能够实时监控 SQL 执行、连接池状态，并提供慢查询分析，帮助开发者优化数据库性能。Druid 具有灵活的配置选项，支持连接泄露检测、SQL 防火墙、黑白名单过滤等安全特性，确保数据库的稳定性与安全性。相比于 Spring Boot 默认使用的 HikariCP，Druid 在可视化监控、扩展性和 SQL 分析方面更具优势，适用于对性能和安全要求较高的 Java 应用。特性和功能： 高性能：Druid连接池通过一些优化策略实现高性能的数据库连接获取和释放。其中包括使用预创建连接来减少连接获取的开销，以及通过连接池扩展机制来快速处理并发请求。此外，Druid还提供了连接的闲置检测和定时回收机制，以避免连接长时间占用资源。监控统计：Druid连接池内置了强大的监控统计功能，可以实时监控连接池的状态、活跃连接数、请求频率、SQL执行情况等。它提供了一个内置的Web界面，可以方便地查看连接池的监控数据，并进行性能分析和故障排查。防止泄露：Druid连接池可以检测和关闭泄露的连接，防止长时间占用数据库连接资源。它提供了一套完善的连接泄露检测和回收机制，以保证连接资源的有效利用。数据库访问优化：Druid连接池支持连接的预处理、批量更新等优化操作，可以提高数据库的访问效率。它还提供了SQL执行的慢查询日志功能，可以帮助开发人员找出慢查询语句，并进行性能优化。安全防护：Druid连接池提供了一些安全防护机制，如SQL防火墙、黑白名单过滤等。这些机制可以保护数据库免受恶意SQL注入等攻击。配置灵活：Druid连接池的配置选项非常灵活，可以根据应用程序的需求进行定制。您可以设置连接池大小、最大连接数、连接超时时间、验证方式等参数，以满足不同场景的需求。 更多的介绍可以参见官网： github /alibaba/druid/ 2 入门使用教程 案例内容：基于SpringBoot3.x，使用MyBatis框架，结合Druid连接池，查询并展示数据库中的全部用户信息项目版本依赖： 后端： SpringBoot：3.1.0JDK：17Mybatis：3.0.1druid-spring-boot-3-starter：1.2.24 前端 vite：6.0.5vue：3.5.13vue-router：4.5.0pinia：2.3.0axios：1.7.9 2.1 后端代码 2.1.1 创建项目 如何快速创建一个SpringBoot新项目可以参见毛毛张的这篇博客：【SpringBoot教程】IDEA快速搭建正确的SpringBoot版本和Java版本的项目下面是毛毛张的完整后端代码文件结构如下图： 2.1.2 导入依赖 更多的关于依赖的介绍可以看第三节，毛毛张在这里只介绍关于这个入门项目的依赖的内容毛毛张针对SpringBoot3.1.0选择的Druid适配的依赖：druid-spring-boot-3-starter：1.2.24需要注意的是，在使用Druid作为连接池的同时，还需要单独导入 MySQL 数据库驱动，通常通过引入 mysql-connector-java 依赖来实现毛毛张在这个任务中为了方便，使用了Mybatis框架，整个项目的pom.xml文件为：<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http:// .w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.zzx</groupId> <artifactId>springboot3-druid-demo</artifactId> <version>0.0.1-SNAPSHOT</version> <name>springboot3-druid-demo</name> <description>springboot3-druid-demo</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-parent</artifactId> <version>3.1.4</version> </parent> <properties> <java.version>17</java.version> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <spring-boot.version>3.1.4</spring-boot.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> <scope>runtime</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> <!-- druid启动器的依赖 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-3-starter</artifactId> <version>1.2.24</version> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.1</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> <dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>${spring-boot.version}</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>17</source> <target>17</target> <encoding>UTF-8</encoding> </configuration> </plugin> <!-- SpringBoot应用打包插件--> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>${spring-boot.version}</version> <configuration> <mainClass>com.zzx.Springboot3DruidDemoApplication</mainClass> <skip>true</skip> </configuration> <executions> <execution> <id>repackage</id> <goals> <goal>repackage</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project> 2.1.3 编写配置文件 下面是整个项目的配置文件application.yaml，关键部分已被注释出来了，更多详细的解释可以参见第三节的内容server: port: 8080 # 服务端口号 spring: datasource: url: jdbc:mysql://localhost:3306/springboot?useSSL=false&autoReconnect=true&characterEncoding=utf8&allowPublicKeyRetrieval=true&serverTimezone=GMT%2B8&allowMultiQueries=true # 数据库地址 driver-class-name: com.mysql.cj.jdbc.Driver # MySQL 8.0 及以上需要 cj，5.7 以下可去掉 cj username: root # 数据库用户名 password: abc123 # 数据库密码 type: com.alibaba.druid.pool.DruidDataSource # 使用 Druid 数据源 druid: # 连接池基本配置 initial-size: 5 # 初始化连接数 min-idle: 10 # 最小空闲连接数 max-active: 20 # 最大连接数 max-wait: 60000 # 最大等待时间（毫秒） time-between-eviction-runs-millis: 60000 # 多少毫秒执行一次空闲连接回收 min-evictable-idle-time-millis: 600000 # 连接最小生存时间（毫秒） max-evictable-idle-time-millis: 1800000 # 连接最大生存时间（毫秒） # 连接校验配置 validation-query: SELECT 1 # 用于测试连接是否可用的 SQL 语句 validation-query-timeout: 2000 # SQL 校验超时时间（毫秒） test-on-borrow: false # 获取连接时是否检测（影响性能，建议关闭） test-on-return: false # 归还连接时是否检测（影响性能，建议关闭） test-while-idle: true # 空闲时是否检测（推荐开启） # 连接池优化配置 phy-max-use-count: 1000 # 每个连接的最大使用次数 pool-prepared-statements: false # 是否开启 PSCache max-open-prepared-statements: 50 # PSCache 允许的最大预编译 SQL 数 # Druid 监控配置 filters: stat,wall,slf4j # 启用监控统计拦截的过滤器（SQL监控、防火墙、日志） # 监控页面配置 stat-view-servlet: enabled: true # 启用内置监控页面 url-pattern: /druid/* # 监控页面路径 login-username: admin # 访问监控页面的用户名 login-password: admin # 访问监控页面的密码 reset-enable: false # 是否允许重置统计数据 allow: 127.0.0.1 # 允许访问的 IP 白名单 deny: 192.168.0.1 # 禁止访问的 IP 黑名单 # Web 监控配置 web-stat-filter: enabled: true # 开启 Web-JDBC 关联监控 url-pattern: /* # 监控所有请求 exclusions: "*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*" # 排除静态资源和监控路径 session-stat-enable: true # 启用 Session 统计 session-stat-max-count: 1000 # Session 最大数量 # SQL 慢查询日志配置 filter: stat: # 是否开启 FilterStat，默认true enabled: true # 是否开启 慢SQL 记录，默认false log-slow-sql: true # 慢 SQL 的标准，默认 3000，单位：毫秒 slow-sql-millis: 5000 # 合并多个连接池的监控数据，默认false merge-sql: false # 日志配置，采用 SLF4J slf4j: enabled: true # 启用日志 statement-log-error-enabled: true # 开启 SQL 语句错误日志 statement-create-after-log-enabled: false statement-close-after-log-enabled: false result-set-open-after-log-enabled: false result-set-close-after-log-enabled: false logging: level: org.springframework.jdbc.core.JdbcTemplate: DEBUG # 开启 SQL 执行日志 mybatis: # Mapper 文件的位置 mapper-locations: classpath:mapper/*Mapper.xml # 实体类的包路径 type-aliases-package: com.zzx.entity configuration: # 自动下划线转驼峰 map-underscore-to-camel-case: true 2.1.4 初始化数据库并创建对应实体类 创建名为springboot的数据库，并创建user_info表：-- 创建数据库 CREATE DATABASE IF NOT EXISTS springboot CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci; USE springboot; -- 删除已存在的 user_info 表（如果存在） DROP TABLE IF EXISTS `user_info`; -- 创建 user_info 表 CREATE TABLE `user_info` ( `id` INT NOT NULL AUTO_INCREMENT, `user_name` VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL, `pass_word` VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL, `age` INT NULL DEFAULT NULL, `gender` VARCHAR(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL, PRIMARY KEY (`id`) USING BTREE ) ENGINE = InnoDB AUTO_INCREMENT = 3 DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci ROW_FORMAT = Dynamic; -- 插入示例数据 INSERT INTO `user_info` (`id`, `user_name`, `pass_word`, `age`, `gender`) VALUES (1, 'sam', 'password123', 32, 'M'), (2, 'hah', 'password456', 10, 'F'); -- 确保外键检查被重新启用 SET FOREIGN_KEY_CHECKS = 1; 对应实体类User：package com.zzx.entity; import lombok.Data; @Data public class User { private Integer id; // 对应数据库中的 `u_id` private String userName; // 对应数据库中的 `u_username` private String passWord; // 对应数据库中的 `u_password` private Integer age; // 对应数据库中的 `u_age` private String gender; // 对应数据库中的 `u_gender` } 2.1.5 编写响应封装与前端展示VO

定义统一的响应封装类 ResVo：

package com.zzx.reponse; public class ResVo<T> { private Integer code; // 状态码 private String message; // 消息内容 private T content; // 内容，可以是任何类型的数据 // 构造方法 public ResVo(Integer code, String message, T content) { this.code = code; this.message = message; this.content = content; } // 成功的返回，通常是常用的，内容可以为空 public static <T> ResVo<T> success(T content) { return new ResVo<>(200, "成功", content); } // 失败的返回，通常返回错误信息 public static <T> ResVo<T> error(Integer code, String message) { return new ResVo<>(code, message, null); } // Getters and Setters public Integer getCode() { return code; } public void setCode(Integer code) { this.code = code; } public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } public T getContent() { return content; } public void setContent(T content) { this.content = content; } }

前端展示对象UserInfoVo，在查询用户信息时通过是把查询到的结果封装在一个实体类中，但是返回给前端的信息不一定是用户的全部信息，例如用户的密码就不能直接返回给前端，或者不要返回，所以毛毛张设计了一个这个类：

package com.zzx.model.vo; import lombok.Data; @Data public class UserInfoVo { //返回给前端展示的数据，密码不能展示，性别转化成数字 private Integer id; private String username; private Integer age; private Integer gender; }

为了节省传输的字符，毛毛张将用户的信息对应的内容转化成数字再返回给前端，因此设计了一个枚举类型UserSexEnum：

package com.zzx.enums; public enum UserSexEnum { M(1, "男"), // M对应男，值为 1 F(0, "女"); // F对应女，值为 0 private int code; // 对应的数字值（1 或 0） private String description; // 性别描述（男 或 女） // 构造方法，用于设置枚举常量的描述和对应的代码 UserSexEnum(int code, String description) { this.code = code; this.description = description; } // 获取性别描述 public String getDescription() { return description; } // 获取对应的数字代码 public int getCode() { return code; } // 根据传入的字符串 'M' 或 'F' 获取对应的性别枚举 public static UserSexEnum fromString(String sexStr) { for (UserSexEnum sex : UserSexEnum.values()) { if (sex.name().equalsIgnoreCase(sexStr)) { return sex; } } throw new IllegalArgumentException("无效的性别字符串: " + sexStr); } // 根据 'M' 或 'F' 获取对应的数字代码 public static int getCodeByString(String sexStr) { UserSexEnum sex = fromString(sexStr); return sex.getCode(); } }

由于User类和UserInfoVo不是完全一一对应的，所以为了数据转换的方便，毛毛张再这里专门写了一个转换类UserConverter：

package com.zzx.converter; import com.zzx.entity.User; import com.zzx.enums.UserSexEnum; import com.zzx.model.vo.UserInfoVo; import java.util.List; import java.util.stream.Collectors; public class UserConverter{ // 单个转换 public static UserInfoVo toUserInfoDTO(User user) { UserInfoVo userInfoVo = new UserInfoVo(); userInfoVo.setId(user.getId()); userInfoVo.setUsername(user.getUserName()); userInfoVo.setAge(user.getAge()); userInfoVo.setGender(UserSexEnum.getCodeByString(user.getGender())); return userInfoVo; } // 批量转换 public static List<UserInfoVo> toUserInfoDTOList(List<User> users) { // 使用 Java 8 的 stream API 进行批量转换 return users.stream() .map(UserConverter::toUserInfoDTO) // 对每个 User 对象进行转换 .collect(Collectors.toList()); // 收集成 List<UserInfoDTO> } } 2.1.6 编写业务逻辑 controller层UserController：package com.zzx.controller; import com.zzx.converter.UserConverter; import com.zzx.entity.User; import com.zzx.model.vo.UserInfoVo; import com.zzx.reponse.ResVo; import com.zzx.service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.util.List; @RestController @RequestMapping("user") public class UserController { @Autowired private UserService userService; @GetMapping("queryAllUserInfo") // 使用 GET 请求 public ResVo<List<UserInfoVo>> queryAllUserInfo() { List<User> userInfoList = userService.queryAllUserInfo(); return ResVo.success(UserConverter.toUserInfoDTOList(userInfoList)); } } service层接口UserService：package com.zzx.service; import com.zzx.entity.User; import java.util.List; public interface UserService { List<User> queryAllUserInfo(); } 服务层实现类UserServiceImpl：package com.zzx.service.impl; import com.zzx.entity.User; import com.zzx.mapper.UserMapper; import com.zzx.service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; @Service public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; @Override public List<User> queryAllUserInfo() { return userMapper.queryAllUserInfo(); } } mapper层UserMapper：package com.zzx.mapper; import org.apache.ibatis.annotations.Mapper; import com.zzx.entity.User; import java.util.List; @Mapper public interface UserMapper { List<User> queryAllUserInfo(); } Mapper 层 SQL 映射配置文件UserMapper.xml：<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.zzx.mapper.UserMapper"> <!-- 声明标签写sql语句 crud select insert update delete 每个标签对应接口的一个方法！ 方法的一个实现！ 注意：mapper接口不能重载！！！ 因为mapper.xml无法识别！ 根据方法名识别！ --> <!-- 查询所有用户 --> <select id="queryAllUserInfo" resultType="com.zzx.entity.User"> SELECT id, user_name, pass_word, age, gender FROM user_info </select> </mapper> 2.1.7 跨域资源共享 由于毛毛张这个代码还有前端代码，涉及到和前端交互，还需要做一个跨域资源共享的配置，毛毛张没有使用@CrossOrigin，而是通过拦截器的方式实现的：package com.zzx.interceptor; import org.springframework.web.servlet.HandlerInterceptor; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class CorsInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { response.setHeader("Access-Control-Allow-Origin", "*"); // 允许所有来源 response.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE"); response.setHeader("Access-Control-Allow-Headers", "Origin, Content-Type, Accept, Authorization"); response.setHeader("Access-Control-Allow-Credentials", "true"); // 处理OPTIONS请求 if ("OPTIONS".equalsIgnoreCase(request.getMethod())) { response.setStatus(HttpServletResponse.SC_OK); return false; // 返回false，表示不再执行后续的Controller方法 } return true; // 继续执行其他拦截器或Controller方法 } } 配置类：package com.zzx.config; import com.zzx.interceptor.CorsInterceptor; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.InterceptorRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addInterceptors(InterceptorRegistry registry) { // 注册 CORS 拦截器 registry.addInterceptor(new CorsInterceptor()) .addPathPatterns("/**") // 拦截所有路径 .excludePathPatterns("/login", "/error"); // 排除登录和错误页面 } } 2.1.8 启动类 启动类SpringbootHicariCpDemoApplication：package com.zzx; import org.mybatis.spring.annotation.MapperScan; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication @MapperScan("com.zzx.mapper") public class SpringbootHicariCpDemoApplication { public static void main(String[] args) { SpringApplication.run(SpringbootHicariCpDemoApplication.class, args); } } 2.1.9 测试 启动后端程序，可以在浏览器中输入http://localhost:8080/user/queryAllUserInfo，返回结果如下则表示后端代码正确无误： 同时也能看见控制台输出使用的连接池为Druid连接池：

完整的后端代码已上传至毛毛张Github仓库：h github /zzxrepository/SpringBootTutorial/tree/master/springboot-mysql/springboot3-druid-demo 2.1.10 Druid后台监控查看 上一个步骤执行完了http://localhost:8080/user/queryAllUserInfo请求，我们可以通过http://127.0.01:8080/druid/login.html来查看Druid的SQL监控页面，查看做了哪些SQL语句。访问该页面首先需要登陆，如下图所示。 登陆密码可以查看配置文件，毛毛张在上面的配置文件中用户名和密码全是admin 登陆成功之后即可查看SQL监控： 2.2 前端代码 前端代码和之前毛毛张介绍的Mybatis教程的代码是一样的，毛毛张在这里不做过多的介绍了，感兴趣的可以查看毛毛张的相关博客：【SpringBoot教程】SpringBoot整合Mybatis - 前后端分离项目 - vue3完整前端代码已上传至毛毛张Github仓库： github /zzxrepository/SpringBootTutorial/tree/master/springboot-mysql/springboot-mysql-demo-vue 2.3 可能会遇到的问题 毛毛张在之前的项目使用的是SpringBoot2.x版本，本项目使用的是3.x版本的，遇到了一些问题，在这里也记录一下 2.3.1 MySQL 连接器版本问题 在 Spring Boot 2.7.6 版本中，MySQL 连接器的版本可以自动推断，但在 Spring Boot 3.x 中，MySQL 连接器的版本需要显式指定，否则会导致构建失败。解决办法是在 pom.xml 中显式指定 mysql-connector-java 的版本，例如：<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.30</version> <!-- 替换为你需要的版本 --> <scope>runtime</scope> </dependency> 2.3.2 javax.annotation.Resource找不到包的问题 在``SpringBoot2.x中毛毛张使用的是@Resource`注解，但是报错： javax.annotation.Resource找不到包原因：Spring Boot 3.x 版本基于 Spring 6，而 javax.annotation 包已不再包含在 Spring 中。此时编译时会出现 程序包javax.annotation不存在 的错误。解决办法有两个选择： 方案 1：显式添加javax.annotation-api依赖：<dependency> <groupId>javax.annotation</groupId> <artifactId>javax.annotation-api</artifactId> <version>1.3.2</version> </dependency> 方案 2：直接使用 Spring 推荐的@Autowired注解替代@Resource，因为@Autowired是Spring的默认注解，且具有更好的兼容性 2.3.3 监控页面报404 启动服务后，打开Druid监控地址http://127.0.0.1:8080/druid/，出现如下图所示错误 错误原因：主要是因为Springboot3.x使用Jakarta EE 10，从 Java EE 变更为 Jakarta EE，包名以 javax开头的需要相应地变更为jakarta，如javax.servlet.*，修改为jakarta.servlet.，目前Druid提供的druid-spring-boot-3-starter中1.2.23之前的依赖仍使用javax的旧包，直到1.2.24才解决，因此毛毛张在上面项目中使用的就是1.2.24版本的依赖 2.3.4 之前SpringBoot3不兼容Druid - 可忽略 在 Spring Boot 3 发布之前，Druid 数据源与 Spring Boot 3 的兼容性较差，特别是在自动配置方面。druid-spring-boot-starter 版本（如 1.2.20）在与 Spring Boot 3 集成时，缺少自动装配配置类，导致无法正常启动，通常会出现 ClassNotFoundException 错误。Caused by: java.lang.ClassNotFoundException: com.alibaba.druid.spring.boot3.autoconfigure.DruidDataSourceAutoConfigure 解决方案：开发者需要手动在 resources 目录下创建 META-INF/spring/ 文件夹，并添加一个名为 org.springframework.boot.autoconfigure.AutoConfiguration.imports 的文件，内容为 com.alibaba.druid.spring.boot3.autoconfigure.DruidDataSourceAutoConfigure，这样 Spring Boot 就能加载并配置 Druid 数据源。 com.alibaba.druid.spring.boot3.autoconfigure.DruidDataSourceAutoConfigure 当前，使用兼容 Spring Boot 3 的 druid-spring-boot-3-starter 版本（如 1.2.24）已经解决了这个问题，不再需要手动配置自动装配类，因此这个问题不会再出现 2.4 总结 毛毛张关于这个入门案例编写的了两个版本的后端代码，已经上传至Github： SpringBoot2.x： github /zzxrepository/SpringBootTutorial/tree/master/springboot-mysql/springboot-druid-demoSpringBoot3.x： github /zzxrepository/SpringBootTutorial/tree/master/springboot-mysql/springboot3-druid-demo 前端代码： github /zzxrepository/SpringBootTutorial/tree/master/springboot-mysql/springboot-mysql-demo-vue 3 配置详解 3.1 导入依赖 不同于HikariCP连接池，Druid连接池需要显示的导入相关依赖 3.1.1 Druid三种依赖 当我们使用Maven Search插件搜索Druid连接池的时候发现阿里巴巴提供了三种依赖，如下图 这三种依赖毛毛张简单介绍一下： druid：Druid 是一个高效、稳定、功能丰富的数据库连接池，广泛应用于 Java 项目中。它具备出色的性能和监控功能，支持 SQL 执行日志、连接池监控、SQL 防火墙等高级功能，尤其在处理大规模高并发数据库请求时表现优异。在 Spring Boot 项目中使用 Druid 时，通常需要手动配置连接池属性，手动注入 DruidDataSource，并且需要开发者自己编写相关的配置类。这种方式适用于不使用 Spring Boot 或对连接池有高度自定义需求的项目。druid-spring-boot-starter：druid-spring-boot-starter 是为 Spring Boot 2.x 项目提供的一款自动化配置的启动器，它简化了 Druid 集成过程，减少了手动配置的步骤。通过该 Starter，开发者只需在 application.properties 或 application.yml 中配置数据源的相关信息，Spring Boot 会自动为你配置并初始化 Druid 连接池。它不仅支持 Druid 数据源的连接池功能，还提供了 Druid 的监控、日志、慢查询等功能的自动配置，非常适合大多数 Spring Boot 2.x 项目，推荐使用此依赖来整合 Druid，避免手动配置的繁琐。druid-spring-boot-3-starter：是专门为 Spring Boot 3.x 版本设计的自动化配置依赖。由于 Spring Boot 3.x 引入了一些不兼容的 API 变更，因此 druid-spring-boot-3-starter 对 Druid 的集成进行了适配，以确保其能够与 Spring Boot 3.x 的特性兼容。与 druid-spring-boot-starter 类似，开发者只需要在配置文件中提供数据库连接信息，Spring Boot 3.x 会自动配置 Druid 数据源以及其他相关功能，如监控、SQL 日志等。这款依赖是 Spring Boot 3.x 项目中使用 Druid 的推荐选择，简化了集成步骤，适合希望快速配置和使用 Druid 数据源的开发者。 总结：因此作为SpringBoot项目 Spring Boot 2.x 项目使用 druid-spring-boot-starterSpring Boot 3.x 项目使用 druid-spring-boot-3-starter 说在前面：毛毛张为什么这么强调版本的原因是因为，如果使用的版本不正确，不匹配，就不能使用Druid 提供的 SQL 监控、连接池监控、慢查询日志以及 Web 和 SQL 的监控页面等功能，如下图所示。因此版本的选择非常重要！ 3.1.2 SpringBoot 2.x 依赖 下面是毛毛张针对SpringBoot2.7.6选择的四个适配的依赖： druid-spring-boot-starter： 1.1.101.1.211.2.151.2.18 依赖文件如下图所示：<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http:// .w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 maven.apache.org/xsd/maven-4.0.0.xsd"> ........ <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-parent</artifactId> <version>2.7.6</version> </parent> <dependencies> ...... <!-- 以下四个版本任选一个 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.1.10</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.1.21</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.2.15</version> </dependency> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.2.18</version> </dependency> ...... </dependencies> ...... </project> 3.1.3 SpringBoot 3.x 依赖 下面是毛毛张针对SpringBoot3.1.0选择的依赖： druid-spring-boot-3-starter：1.2.24 完整的项目依赖为：<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http:// .w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 maven.apache.org/xsd/maven-4.0.0.xsd"> ...... <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-parent</artifactId> <version>3.1.0</version> </parent> ...... <dependencies> ...... <!-- druid启动器的依赖 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-3-starter</artifactId> <version>1.2.24</version> </dependency> ...... </dependencies> ...... </project> 3.2 常见配置 下面是HicariCP连接池常见的配置：spring: datasource: url: jdbc:mysql://localhost:3306/springboot?useSSL=false&autoReconnect=true&characterEncoding=utf8&allowPublicKeyRetrieval=true&serverTimezone=GMT%2B8&allowMultiQueries=true # 数据库地址 driver-class-name: com.mysql.cj.jdbc.Driver # MySQL 8.0 及以上需要 cj，5.7 以下可去掉 cj username: root # 数据库用户名 password: abc123 # 数据库密码 type: com.alibaba.druid.pool.DruidDataSource # 使用 Druid 数据源 druid: # 连接池基本配置 initial-size: 5 # 初始化连接数 min-idle: 10 # 最小空闲连接数 max-active: 20 # 最大连接数 max-wait: 60000 # 最大等待时间（毫秒） time-between-eviction-runs-millis: 60000 # 多少毫秒执行一次空闲连接回收 min-evictable-idle-time-millis: 600000 # 连接最小生存时间（毫秒） max-evictable-idle-time-millis: 1800000 # 连接最大生存时间（毫秒） # 连接校验配置 validation-query: SELECT 1 # 用于测试连接是否可用的 SQL 语句 validation-query-timeout: 2000 # SQL 校验超时时间（毫秒） test-on-borrow: false # 获取连接时是否检测（影响性能，建议关闭） test-on-return: false # 归还连接时是否检测（影响性能，建议关闭） test-while-idle: true # 空闲时是否检测（推荐开启） # 连接池优化配置 phy-max-use-count: 1000 # 每个连接的最大使用次数 pool-prepared-statements: false # 是否开启 PSCache max-open-prepared-statements: 50 # PSCache 允许的最大预编译 SQL 数 # Druid 监控配置 filters: stat,wall,log4j2 # 启用监控统计拦截的过滤器（SQL监控、防火墙、日志） # 监控页面配置 stat-view-servlet: enabled: true # 启用内置监控页面 url-pattern: /druid/* # 监控页面路径 login-username: admin # 访问监控页面的用户名 login-password: admin # 访问监控页面的密码 reset-enable: false # 是否允许重置统计数据 allow: 127.0.0.1 # 允许访问的 IP 白名单 deny: 192.168.0.1 # 禁止访问的 IP 黑名单 # Web 监控配置 web-stat-filter: enabled: true # 开启 Web-JDBC 关联监控 url-pattern: /* # 监控所有请求 exclusions: "*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*" # 排除静态资源和监控路径 session-stat-enable: true # 启用 Session 统计 session-stat-max-count: 1000 # Session 最大数量 # SQL 慢查询日志配置 filter: stat: # 是否开启 FilterStat，默认true enabled: true # 是否开启 慢SQL 记录，默认false log-slow-sql: true # 慢 SQL 的标准，默认 3000，单位：毫秒 slow-sql-millis: 5000 # 合并多个连接池的监控数据，默认false merge-sql: false # 日志配置，采用 SLF4J slf4j: enabled: true # 启用日志 statement-log-error-enabled: true # 开启 SQL 语句错误日志 statement-create-after-log-enabled: false statement-close-after-log-enabled: false result-set-open-after-log-enabled: false result-set-close-after-log-enabled: false 上面配置主要分为三部分：数据源配置、数据库连接池配置和Druid监控配置 3.3 数据源配置解析 下面部分属于数据源配置：spring: datasource: url: jdbc:mysql://localhost:3306/springboot?useSSL=false&autoReconnect=true&characterEncoding=utf8&allowPublicKeyRetrieval=true&serverTimezone=GMT%2B8&allowMultiQueries=true # 数据库地址 driver-class-name: com.mysql.cj.jdbc.Driver # MySQL 8.0 及以上需要 cj，5.7 以下可去掉 cj username: root # 数据库用户名 password: abc123 # 数据库密码 type: com.alibaba.druid.pool.DruidDataSource # 使用 Druid 数据源 配置解析： url：定义数据库连接的详细信息，包括： localhost:3306（服务器地址和端口）springboot（数据库名称）连接参数 driver-class-name：指定数据库连接的驱动，MySQL 8.x使用 com.mysql.cj.jdbc.Driverusername 和 password：提供访问数据库的身份凭证type：指定数据库连接池的实现，配置为 com.alibaba.druid.pool.DruidDataSource url连接参数详解： useUnicode=true&characterEncoding=UTF-8： 确保数据库与应用之间的字符编码一致，防止乱码问题推荐使用 utf8mb4 以支持更多字符（如表情符号） serverTimezone=UTC： 指定数据库服务器的时区，避免时间处理错误可选值： UTC：世界标准时间，比北京时间（CST）早 8 小时Asia/Shanghai：中国标准时间（推荐） 说明：MySQL 6.0 及以上的 com.mysql.cj.jdbc.Driver 需要显式指定时区，否则可能导致时区不匹配的异常 useSSL=false： 指定是否启用 SSL 连接在生产环境（如 Linux 服务器部署）通常关闭 SSL 连接，以减少额外的安全配置建议：在公共网络或云数据库环境中建议开启 SSL autoReconnect=true&failOverReadOnly=false： autoReconnect=true：允许 JDBC 驱动在连接意外断开时自动重连（已弃用，推荐使用连接池）failOverReadOnly=false：防止发生故障转移时连接错误地设置为只读模式 allowPublicKeyRetrieval=true： 允许客户端从 MySQL 服务器检索公钥，以进行密码验证安全建议：生产环境下尽量避免使用该参数，建议启用 SSL 进行安全通信 zeroDateTimeBehavior=convertToNull： 当数据库中的日期时间值为 0000-00-00 00:00:00 时，转换为 null，避免 Java 应用程序在处理无效日期值时出错 rewriteBatchedStatements=true： 启用批量执行优化，提高批量 INSERT、UPDATE 的执行效率适用于大数据量操作，不适用于 SELECT 查询 3.4 连接池配置详解

下面是Druid连接池的配置：

druid: # 连接池基本配置 initial-size: 5 # 初始化连接数 min-idle: 10 # 最小空闲连接数 max-active: 20 # 最大连接数 max-wait: 60000 # 最大等待时间（毫秒） time-between-eviction-runs-millis: 60000 # 多少毫秒执行一次空闲连接回收 min-evictable-idle-time-millis: 600000 # 连接最小生存时间（毫秒） max-evictable-idle-time-millis: 1800000 # 连接最大生存时间（毫秒） # 连接校验配置 validation-query: SELECT 1 # 用于测试连接是否可用的 SQL 语句 validation-query-timeout: 2000 # SQL 校验超时时间（毫秒） test-on-borrow: false # 获取连接时是否检测（影响性能，建议关闭） test-on-return: false # 归还连接时是否检测（影响性能，建议关闭） test-while-idle: true # 空闲时是否检测（推荐开启） # 连接池优化配置 phy-max-use-count: 1000 # 每个连接的最大使用次数 pool-prepared-statements: false # 是否开启 PSCache max-open-prepared-statements: 50 # PSCache 允许的最大预编译 SQL 数

配置属性列表介绍：

配置项名称缺省值说明connectProperties{}map方式放入自定义的key和value，在Filter等地方可以获取该信息进行相应逻辑控制connectionPropertiesnull字符串方式放入自定义的key和value，键值对用分号隔开，比如“a=b;c=d”，传入空白字符串表示清空属性，实际拆分字符串后赋值给connectProperties，在Filter等地方可以获取该信息进行相应逻辑控制connectTimeout0新增的控制创建连接时的socket连接最大等待超时，单位是毫秒，默认0表示永远等待，工作原理是在创建连接时将该值设置到对应数据库驱动的属性信息中由其JDBC驱动进行控制connectionInitSqls[]数组方式定义物理连接初始化的时候执行的1到多条sql语句，比如连接MySQL数据库使用低版本驱动的情况下，想使用utf8mb4,则可以配置sql为： set NAMES ‘utf8mb4’createSchedulernull可以使用定时线程池方式异步创建连接，比起默认的单线程创建连接方式，经实际验证这种更可靠dbTypenull对于不是Druid自动适配支持的db类型，可以强制指定db类型，字符串值来自com.alibaba.druid.DbType的枚举名destroySchedulernull可以使用定时线程池方式异步创建连接，比起默认的单线程创建连接方式，经实际验证这种更可靠driverClassName根据url自动识别这一项可配可不配，如果不配置druid会根据url自动识别dbType，然后选择相应的driverClassNameexceptionSorternull当数据库抛出一些不可恢复的异常时，抛弃连接failFastfalsenullfilters属性类型是逗号隔开的字符串，通过别名的方式配置扩展插件，插件别名列表请参考druid jar包中的 /META-INF/druid-filter.properties,常用的插件有： 监控统计用的filter:stat 日志用的filter:log4j 防御sql注入的filter:wall 防御sql注入的filter:wallinitialSize0初始化数据源时建立物理连接的个数。初始化发生在显示调用init方法，或者第一次getConnection时keepAlivefalse连接池中的minIdle数量以内的连接，空闲时间超过minEvictableIdleTimeMillis，则会执行keepAlive操作。实际项目中建议配置成truekeepAliveBetweenTimeMillis120000nulllogAbandonedfalse在开启removeAbandoned为true的情况，可以开启该设置，druid在销毁未及时关闭的连接时，则会输出日志信息，便于定位连接泄露问题loginTimeout单位是秒，底层调用DriverManager全局静态方法maxActive8连接池最大活跃连接数量，当连接数量达到该值时，再获取新连接时，将处于等待状态，直到有连接被释放，才能借用成功maxEvictableIdleTimeMillis25200000nullmaxIdle8已经彻底废弃，配置了也没效果，以maxActive为准maxOpenPreparedStatements10nullmaxPoolPreparedStatementPerConnectionSize10要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100maxWait-1获取连接时最大等待时间，单位毫秒。配置了maxWait之后，缺省启用公平锁，并发效率会有所下降，如果需要可以通过配置useUnfairLock属性为true使用非公平锁。minEvictableIdleTimeMillis1800000连接保持空闲而不被驱逐的最小时间minIdle0连接池最小空闲数量nameDataSource-****配置这个属性的意义在于，如果存在多个数据源，监控的时候可以通过名字来区分开来。如果没有配置，将会生成一个名字，格式是：“DataSource-” + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的，强行设置name会出错。详情-点此处。numTestsPerEvictionRun3不再使用，已经彻底废弃，一个DruidDataSource只支持一个EvictionRunpasswordnull连接数据库的密码。如果你不希望密码直接写在配置文件中，可以使用passwordCallback进行配置，或者使用ConfigFilter。详细看这里passwordCallbacknull可以自定义实现定制的PasswordCallback，然后实现定制的密码解密效果phyTimeoutMillis-1强制回收物理连接的最大超时时长，大于0的情况下才生效，当物理创建之后存活的时长超过该值时，该连接会强制销毁，便于重新创建新连接，建议可以配置成7小时的毫秒值，比如25200000，这样可以规避MySQL的8小时连接断开问题poolPreparedStatementsfalse是否缓存preparedStatement，也就是PSCache。PSCache对支持游标的数据库性能提升巨大，比如说oracle。在mysql下建议关闭。proxyFilters类型是List<com.alibaba.druid.filter.Filter>，如果同时配置了filters和proxyFilters，是组合关系，并非替换关系queryTimeout0控制查询结果的最大超时，单位是秒，大于0才生效，最终底层调用是java.sql.Statement.setQueryTimeout(int)removeAbandonedfalse是否回收泄露的连接,默认不开启，建议只在测试环境设置未开启，利用测试环境发现业务代码中未正常关闭连接的情况removeAbandonedTimeoutMillis300000开启回收泄露连接的最大超时，默认300秒表示连接被借出超过5分钟后，且removeAbandoned开启的情况下，强制关闭该泄露连接socketTimeout0新增的控制创建连接时的socket最大读超时，单位是毫秒，默认0表示永远等待，配置成10000则表示db操作如果在10秒内未返回应答，将抛出异常，工作原理是在创建连接时将该值设置到对应数据库驱动的属性信息中由其JDBC驱动进行控制testOnBorrowfalse申请连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能，其实一般情况下都可以开启，只有性能要求极其高且连接使用很频繁的情况下才有必要禁用。testOnReturnfalse归还连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能，这个一般不需要开启。testWhileIdletrue建议配置为true，不影响性能，并且保证安全性。申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。timeBetweenEvictionRunsMillis60000有两个含义： 1) Destroy线程会检测连接的间隔时间，如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。 2) testWhileIdle的判断依据，详细看testWhileIdle属性的说明transactionQueryTimeout0控制查询结果的最大超时，单位是秒，大于0才生效，最终是在开启事务的情况下底层调用java.sql.Statement.setQueryTimeout(int)url连接数据库的url，不同数据库不一样。例如： mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnautousernamenull连接数据库的用户名validationQuerynull用来检测连接是否有效的sql，要求是一个查询语句，常用select ‘x’。如果validationQuery为null，testOnBorrow、testOnReturn、testWhileIdle都不会起作用。validationQueryTimeout-1单位：秒，检测连接是否有效的超时时间，大于0才生效。底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法 3.5 Druid监控配置 下面是Druid监控配置： # Druid 监控配置 filters: stat,wall,slf4j # 启用监控统计拦截的过滤器（SQL监控、防火墙、日志） # 监控页面配置 stat-view-servlet: enabled: true # 启用内置监控页面 url-pattern: /druid/* # 监控页面路径 login-username: admin # 访问监控页面的用户名 login-password: admin # 访问监控页面的密码 reset-enable: false # 是否允许重置统计数据 allow: 127.0.0.1 # 允许访问的 IP 白名单 deny: 192.168.0.1 # 禁止访问的 IP 黑名单 # Web 监控配置 web-stat-filter: enabled: true # 开启 Web-JDBC 关联监控 url-pattern: /* # 监控所有请求 exclusions: "*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*" # 排除静态资源和监控路径 session-stat-enable: true # 启用 Session 统计 session-stat-max-count: 1000 # Session 最大数量 # SQL 慢查询日志配置 filter: stat: enabled: true # 是否开启 FilterStat，默认true log-slow-sql: true # 是否开启 慢SQL 记录，默认false slow-sql-millis: 5000 # 慢 SQL 的标准，默认 3000，单位：毫秒 merge-sql: false # 合并多个连接池的监控数据，默认false # 日志配置，采用 SLF4J slf4j: enabled: true # 启用日志 statement-log-error-enabled: true # 开启 SQL 语句错误日志 statement-create-after-log-enabled: false statement-close-after-log-enabled: false result-set-open-after-log-enabled: false result-set-close-after-log-enabled: false 配置详解： filters: 启用 Druid 的过滤器，stat 用于SQL监控，wall 用于防火墙，log4j2 用于日志记录。stat-view-servlet: 启用 Druid 内置监控页面，配置路径、用户名、密码等。可以通过 url-pattern 指定访问路径。web-stat-filter: 配置 Web-JDBC 关联监控，可以监控 HTTP 请求的详细数据，如 Session 信息。filter.stat: 配置 Druid 的 SQL 慢查询日志功能，记录执行时间超过设定阈值的 SQL 查询。slf4j: 配置 Druid 使用 SLF4J 进行日志输出，开启 SQL 语句错误日志、创建语句日志等。 3.6 总结 使用 Druid 连接池的核心关键点在于选择与项目所使用的 Spring Boot 版本兼容的 Druid 依赖版本。 如果版本选择不当，虽然 Druid 连接池仍然可以正常使用，但后台的 SQL 监控功能可能无法正常工作。毛毛张在其文章中详细介绍了不同版本的兼容性问题，通常，如果遇到 SQL 后台监控无法显示的情况，可以尝试升级到 Druid 的最新版本，以解决此类问题。 4 总结 更多关于Druid连接池的介绍可以查看官网连接： github /alibaba/druid/tree/master更多关于Druid配置文件的介绍可以查看官网的配置文件的介绍： github /alibaba/druid/tree/master/druid-spring-boot-starter#如何配置-filter 参考文献 juejin /post/7329033419328307226 zhuanlan.zhihu /p/686960884 blog.csdn.net/hansome_hong/article/details/124320410 juejin /post/7224499191962714171#heading-2 blog.csdn.net/hansome_hong/article/details/124320410 pdai.tech/md/spring/springboot/springboot-x-mysql-HikariCP.html blog.csdn.net/doubiy/article/details/131578389 blogs /lyluoye/p/16627840.html github /brettwooldridge/HikariCP blogs /zhaojinhui/p/17579010.html javabetter /springboot/mysql-druid.html juejin /post/7374356945702322214 blog.csdn.net/munangs/article/details/124724091 zhuanlan.zhihu /p/636184214 github /alibaba/druid/wiki/DruidDataSource配置属性列表

---

都看到这了，不妨一键三连再走吧！ 🌈欢迎和毛毛张一起探讨和交流！ 联系方式点击下方个人名片

---