Maven配置Mybatis项目异常：“java.lang.ClassNotFoundException: Cannot find class: com.mysql.jdbc.Driver”解决办法

一、问题出现

初次使用Maven配置Mybatis项目环境，在测试mysql数据库连接时出现了异常

Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: 
### Error querying database.  Cause: java.sql.SQLException: Error setting driver on UnpooledDataSource. Cause: java.lang.ClassNotFoundException: Cannot find class: com.mysql.jdbc.Driver

查询资料后，得知是Mybatis XML配置文件出了问题

二、问题解决

此时，我的pom.xml配置如下所示：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0modelVersion>

  <groupId>top.wenzhao18groupId>
  <artifactId>MavenMabaitsTestartifactId>
  <version>0.0.1-SNAPSHOTversion>
  <packaging>jarpackaging>

  <name>MavenMabaitsTestname>
  <url>http://maven.apache.orgurl>

  <properties>
    <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
  properties>

<dependencies>
        
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>3.8.1version>
            <scope>testscope>
        dependency>

		
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatisartifactId>
            <version>3.4.5version>
        dependency>

        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>8.0.15version>
        dependency>


        <dependency>
            <groupId>log4jgroupId>
            <artifactId>log4jartifactId>
            <version>1.2.12version>
        dependency>

    dependencies>
project>

上网检索了一番后，发现可能是mysql数据库驱动版本的冲突/不兼容问题，于是将mysql依赖版本

        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.6version>
        dependency>

修改为8.0.15

        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>8.0.15version>
        dependency>

再次运行，发现还是有报错

### Error querying database.  Cause: java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.

这时，修改Mybatis XML配置文件dataSource中的url属性，在其后添加?serverTimezone=GMT，即将mysql的时区设置为美国时间，如图所示：

此时再运行程序，发现已经能成功连接数据库了。

三、问题总结

初次使用Maven配置Mybatis项目报了这个异常，排错检索资料用时一天（一晚上+一个下午），

由此体会到Maven依赖冲突、版本不兼容的可怕支配力量（不）

1. 对于Cannot find class: com.mysql.jdbc.Driver异常的排查，我是首先所锁定异常出现的位置。

2. 从Error setting driver on UnpooledDataSource这句，我们就可以粗略判定是配置文件设置有误，由此可以定位到Mybatis的XML配置文件。

3. 而后再看Cannot find class: com.mysql.jdbc.Driver，对比dataSource下的driver属性，我们可以得知在创建SqlSessionFactory对象解析Mybatis配置文件时，读取driver属性出了问题；而问题的根源就是在lib中找不到mysql的驱动。

4. 再回过头检查pom.xml中的mysql依赖，可以大胆猜测是版本的问题。

四、参考文献

MySQL JDBC驱动版本与MySQL数据库版本对应关系

MyBatis问题1 java.lang.ClassNotFoundException: Cannot find class: com.mysql.cj.jdbc.Driver

JDBC出现The server time zone value ‘Öйú±ê׼ʱ¼ä’ is unrec问题

Mybatis从入门到精通-刘增辉