driverClassName: com.mysql.cj.jdbc.Driver为啥还加载类Loading class `com.mysql.jdbc.Driver'.

<think>嗯，用户遇到了Spring中数据库连接失败的问题，具体报错是com.mysql.cj.jdbc.Driver和DruidDataSource相关。这应该是配置MySQL JDBC驱动时出现的典型问题。 用户可能正在开发Spring Boot项目，使用了Druid连接池和MySQL数据库。从报错信息看，核心问题很可能是驱动类加载失败，常见原因包括：驱动jar包缺失、版本不匹配、类名拼写错误或Druid配置不当。 让我梳理几个关键排查方向： 第一要确认驱动依赖。用户提供的引用[2]提到mysql-connector-java版本问题，这很关键。现在MySQL 8+必须用cj.jdbc.Driver，且版本要匹配。需要检查pom.xml是否正确定义了<mysql.version>属性，比如8.0.28版本示例。 第二检查Druid配置。用户提到DruidDataSource，要特别注意spring.datasource.druid.driver-class-name属性是否显式设置为com.mysql.cj.jdbc.Driver。如果没配置，Druid可能自动加载旧版驱动导致失败。 第三验证连接参数。url里useSSL和时区设置常被忽略，MySQL 8需要显式关闭SSL（useSSL=false）并指定serverTimezone，比如Asia/Shanghai。 第四查看依赖冲突。用户使用Maven可能存在驱动包被覆盖的情况，可以用mvn dependency:tree排查。特别要注意是否同时存在mysql-connector-java和旧版mysql-connector的冲突。 第五检查日志细节。Druid的create connection error会输出具体堆栈，如果提示"Loading class `com.mysql.jdbc.Driver' is deprecated"就肯定是驱动类用错了。 最后想到一个易错点：Spring Boot 2.7+默认不包含数据库驱动，必须显式声明依赖，这点和早期版本不同。 用户可能需要分步操作指导，所以回答里要给出具体配置示例和命令。另外生成的问题要覆盖驱动原理、连接池优化等延伸知识点，帮助用户建立系统认知。</think>### Spring数据库连接失败问题排查指南（com.mysql.cj.jdbc.Driver + Druid） #### 1. **检查MySQL驱动依赖（核心步骤）** ```xml <!-- pom.xml 示例 --> <properties> <java.version>1.8</java.version> <mysql.version>8.0.33</mysql.version> <!-- 推荐最新稳定版 --> </properties> <dependencies> <!-- MySQL驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.version}</version> </dependency> <!-- Druid连接池 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.2.18</version> </dependency> </dependencies> ``` **验证步骤**： 1. 执行 `mvn dependency:tree | grep mysql` 确认驱动版本 2. 检查是否存在版本冲突（如旧版 `mysql-connector-java:5.x`） #### 2. **Druid配置检查（application.yml）** ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/yourdb?useSSL=false&serverTimezone=Asia/Shanghai username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver # 关键配置 type: com.alibaba.druid.pool.DruidDataSource druid: initial-size: 5 min-idle: 5 max-active: 20 validation-query: SELECT 1 # 连接校验 ``` #### 3. **常见错误原因排查 - **驱动类名错误**： - 正确：`com.mysql.cj.jdbc.Driver`（MySQL 8.0+） - 错误：`com.mysql.jdbc.Driver`（旧版） - **JDBC URL格式问题**： ```diff - jdbc:mysql://localhost:3306/db + jdbc:mysql://localhost:3306/db?serverTimezone=Asia/Shanghai&characterEncoding=utf8 ``` - **依赖冲突**： 检查是否有其他数据源依赖： ```bash mvn dependency:tree | grep -E 'mysql|druid|pool' ``` #### 4. **日志分析关键点 查看错误日志中的 **Caused by** 部分： ``` Caused by: java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver ``` 此错误表明驱动类未加载，需检查依赖[^1]。 #### 5. **解决方案流程 ```mermaid graph TD A[连接失败] --> B{检查驱动依赖} B -->|缺失| C[添加mysql-connector-java依赖] B -->|存在| D{检查驱动类名} D -->|错误| E[修改为com.mysql.cj.jdbc.Driver] D -->|正确| F{检查JDBC URL} F -->|时区/SSL问题| G[添加serverTimezone参数] F -->|正确| H{检查Druid配置} H -->|validationQuery缺失| I[配置SELECT 1] H -->|正确| J[查看网络/数据库状态] ``` #### 6. **终极验证代码 ```java // 手动加载驱动测试（仅用于诊断） Class.forName("com.mysql.cj.jdbc.Driver"); try (Connection conn = DriverManager.getConnection( "jdbc:mysql://localhost:3306/test?serverTimezone=UTC", "user", "pass")) { System.out.println("连接成功！"); } ``` #### 引用说明： > [^1]: 当出现 `ClassNotFoundException: com.mysql.cj.jdbc.Driver` 时，表明 JVM 无法加载 MySQL 驱动类，通常由依赖缺失或版本不匹配导致[^1]。 > [^2]: MySQL 8.0+ 必须使用 `cj.jdbc.Driver` 驱动类，且 JDBC URL 需显式指定时区参数（如 `serverTimezone=Asia/Shanghai`）[^2]。 --- ###

### 正确加载 MySQL 驱动程序并解决驱动程序类的弃用问题 为了正确加载 MySQL 驱动程序并解决 `com.mysql.jdbc.Driver` 被废弃的问题，可以按照以下方法操作： #### 1. 使用新的驱动程序类名 自 MySQL Connector/J 版本 8.x 开始，推荐使用的驱动程序类名为 `com.mysql.cj.jdbc.Driver` 替代旧版本中的 `com.mysql.jdbc.Driver`[^2]。 #### 2. 更新依赖项 如果项目使用 Maven 构建工具，则需更新 `pom.xml` 文件以引入最新版的 MySQL 连接器库。以下是示例配置： ```xml <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> <!-- 确保使用最新的稳定版本 --> </dependency> ``` 对于 Gradle 用户，应在 `build.gradle` 中添加如下内容： ```gradle implementation 'mysql:mysql-connector-java:8.0.33' ``` #### 3. 修改 JDBC URL 参数 新版驱动程序默认启用了时区敏感特性，因此建议在连接字符串中显式指定服务器端时区参数。例如： ```properties url=jdbc:mysql://localhost:3306/yourDatabase?serverTimezone=UTC&useSSL=false ``` 此设置可防止因客户端与服务端时间不一致引发异常[^3]。 #### 4. 加载驱动的方式调整 现代 Java 应用通常无需手动注册驱动实例，因为通过标准接口 (`DriverManager`) 即能自动完成初始化过程。但如果仍希望保留显示调用逻辑，应采用新类路径名称实现： ```java try { Class.forName("com.mysql.cj.jdbc.Driver"); } catch (ClassNotFoundException e) { System.out.println("MySQL Driver not found."); } ``` 需要注意的是，在大多数情况下可以直接跳过这一步骤，仅依靠提供完整的数据库链接地址即可建立会话[^4]。 --- ### 示例代码展示 下面给出一段基于 Spring Boot 的完整数据源配置样例供参考： ```yaml spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/sampledb?serverTimezone=UTC&useSSL=false username: root password: secret ``` 或者当应用运行于测试环境时，也可以利用 properties 文件定义属性集： ```properties driverClassName=com.mysql.cj.jdbc.Driver url=jdbc:mysql://localhost:3306/testdb?serverTimezone=CET&useSSL=true username=tester password=password123 initialization-mode=always ``` 以上两种方式均能够有效支持当前主流框架下的集成需求[^5]。 ---