### 问题分析
在使用
MyBatis 时，出现如下异常：
```
Error setting
driver on UnpooledDataSource
. Cause
: java.lang
.ClassNotFoundException
: Cannot find class: com.mysql
.cj
.jdbc.Driver
```
该异常表明在运行时无法找到 MySQL
JDBC 驱动类 `
com.mysql
.cj
.jdbc.Driver`。此类问题通常与以下几个因素有关：
- 项目未正确引入 MySQL
JDBC 驱动依赖。
- 配置文件中使用的
JDBC URL 或驱动类名不匹配实际引入的 MySQL 版本。
- 使用了
Maven 或 Gradle 等构建工具，但依赖未被正确下载或引入到运行时类路径中。
###
解决方案
#### 1
. 添加 MySQL
JDBC 依赖
确保在 `pom
.xml`（
Maven 项目）或 `build
.gradle`（Gradle 项目）中添加了正确的 MySQL
JDBC 驱动依赖。对于 MySQL 8
.x 及以上版本，应使用 `mysql-connector-
java` 8
.x，并指定驱动类为 `
com.mysql
.cj
.jdbc.Driver`。
Maven 示例配置如下：
```xml
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-
java</artifactId>
<version>8
.0
.33</version>
</dependency>
```
对于 MySQL 5
.x，应使用 `
com.mysql
.jdbc.Driver` 并引入对应的
JDBC 驱动版本[^1]。
#### 2
. 检查
JDBC URL 和驱动类配置
在
MyBatis 的配置文件 `
mybatis-config
.xml` 或 Spring Boot 的 `application
.properties` 中，确保
JDBC URL 和驱动类的配置与使用的 MySQL 版本一致。
MyBatis 配置示例如下：
```xml
<dataSource type="UNPOOLED">
<property name="
driver" value="
com.mysql
.cj
.jdbc.Driver"/>
<property name="url" value="
jdbc:mysql
://localhost
:3306/your_database?useSSL=false&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="password"/>
</dataSource>
```
Spring Boot 配置示例如下：
```properties
spring
.datasource
.url=
jdbc:mysql
://localhost
:3306/your_database?useSSL=false&serverTimezone=UTC
spring
.datasource
.username=root
spring
.datasource
.password=password
spring
.datasource
.driver-
class-name=
com.mysql
.cj
.jdbc.Driver
```
#### 3
. 确保依赖被正确加载
如果使用
Maven 构建项目，运行以下命令以确保依赖被正确下载并加入类路径：
```bash
mvn clean install
```
在 IDE 中（如 IntelliJ IDEA），检查项目模块的依赖是否包含 `mysql-connector-
java`。如果没有，请手动刷新
Maven 依赖或重新导入项目[^2]。
#### 4
. 检查运行时类路径
在某些情况下，即使依赖已正确配置，也可能因运行时类路径缺失而导致驱动类无法加载。例如，使用命令行运行程序时，需确保 `mysql-connector-
java.jar` 被包含在 `
CLASSPATH` 中。
Java 命令行示例：
```bash
java -cp
.;path/to/mysql-connector-
java-8
.0
.33
.jar
com.example
.Main
```
#### 5
. 检查 MySQL 版本与驱动类的兼容性
MySQL 5
.x 使用 `
com.mysql
.jdbc.Driver`，而 MySQL 8
.x 使用 `
com.mysql
.cj
.jdbc.Driver`。如果项目中配置了错误的驱动类，将导致 `
ClassNotFoundException`。请根据实际安装的 MySQL 版本调整驱动类配置[^5]。
###
博客涉及信息技术领域，包含Java、MyBatis、Oracle数据库和Maven等关键内容。Java是常用编程语言，MyBatis是数据持久层框架，Oracle是知名数据库，Maven用于项目构建和依赖管理。
扫一扫
701
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
