MySQL Hibernate – ClassNotFoundException: com.mysql.jdbc.Driver错误

在使用Hibernate连接MySQL数据库的时候，有时候会遇到一个异常，如下所示：

java.lang.ClassNotFoundException: com.mysql.jdbc.Driver

这个异常的原因是没有找到MySQL数据库的驱动程序，导致Hibernate无法连接到MySQL数据库。在本文中，我们将详细讨论这个异常，并介绍解决这个异常的方法。

阅读更多：MySQL 教程

问题分析

出现这个异常的原因是因为在classpath中没有添加MySQL数据库的驱动程序。Hibernate使用JDBC API来连接数据库，MySQL JDBC驱动程序是一个JDBC的实现，它有一个类com.mysql.jdbc.Driver，这个类是MySQL JDBC驱动程序的一部分。如果没有将MySQL数据库的驱动程序添加到classpath中，就无法找到这个类，从而导致这个异常发生。

解决方法

解决这个异常的方法很简单，只需要将MySQL JDBC驱动程序添加到classpath中即可。以下是两种添加MySQL JDBC驱动程序的方法。

方法一：手动添加MySQL JDBC驱动程序

下载MySQL JDBC驱动程序。可以从MySQL官方网站下载：https://dev.mysql.com/downloads/connector/j/。下载完成后，得到一个名为mysql-connector-java-x.x.x.jar的文件。
将下载的mysql-connector-java-x.x.x.jar文件复制到一个目录中，例如/lib目录。
在classpath中添加以下条目：

-classpath /lib/mysql-connector-java-x.x.x.jar

其中，x.x.x是MySQL JDBC驱动程序的版本号，具体替换成所下载的版本号即可。

方法二：通过Maven添加MySQL JDBC驱动程序

如果使用Maven来管理项目依赖，则可以通过Maven来添加MySQL JDBC驱动程序。

在项目的pom.xml文件中添加以下依赖项：

<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>x.x.x</version>
</dependency>

其中，x.x.x是MySQL JDBC驱动程序的版本号，具体替换成所需的版本号即可。添加依赖之后，Maven会自动下载并添加MySQL JDBC驱动程序到classpath中。

示例

以下是一个使用Hibernate连接MySQL数据库的示例，在这个示例中，使用方法一手动添加MySQL JDBC驱动程序。

首先下载MySQL JDBC驱动程序，并将其复制到项目的lib目录中。
创建一个名为Employee.java的实体类，表示员工信息。

package com.example;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Employee {

    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String lastName;

    protected Employee() {}

    public Employee(String firstName, String lastName) {
        this.firstName = firstName;
        this.lastName = lastName;
    }

    public String getFirstName() {
        return firstName;
    }

    public String getLastName() {
        return lastName;
    }

    @Override
    public String toString() {
        return String.format("Employee[id=%d, firstName='%s', lastName='%s']", 
            id, firstName, lastName);
    }

}

编写Hibernate的配置文件hibernate.cfg.xml，指定MySQL数据库的连接信息。

<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD//EN"
        "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
        <property name="hibernate.dialect">org.hibernate.dialect.MySQL5Dialect</property>
        <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/example</property>
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.connection.password">password</property>
        <mapping class="com.example.Employee"/>
    </session-factory4. 编写测试类TestHibernate，测试Hibernate是否能够连接MySQL数据库。

```java
package com.example;

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
import org.hibernate.cfg.Configuration;
import org.hibernate.service.ServiceRegistry;

public class TestHibernate {

    private static SessionFactory sessionFactory;

    public static void main(String[] args) {
        Configuration configuration = new Configuration().configure("hibernate.cfg.xml");
        ServiceRegistry serviceRegistry = new StandardServiceRegistryBuilder()
                .applySettings(configuration.getProperties()).build();
        sessionFactory = configuration.buildSessionFactory(serviceRegistry);
        Session session = sessionFactory.openSession();
        Transaction transaction = session.beginTransaction();
        Employee employee = new Employee("John", "Doe");
        session.persist(employee);
        transaction.commit();
        session.close();
        System.out.println("Employee saved successfully!");
    }

}

在这个测试类中，首先创建了一个Hibernate的Configuration对象，并通过configure方法指定了Hibernate的配置文件。然后创建了一个Hibernate的ServiceRegistry，并通过applySettings方法将Hibernate的配置文件中的属性应用到ServiceRegistry中。最后构建SessionFactory对象，并使用.openSession方法打开一个Session对象。使用Session.persist方法将Employee对象存储到MySQL数据库中。最后提交事务，关闭Session。如果一切顺利，控制台将输出”Employee saved successfully!”。

总结

本文介绍了在使用Hibernate连接MySQL数据库的过程中，可能会遇到的一个异常：ClassNotFoundException: com.mysql.jdbc.Driver。分析了这个异常的原因，并介绍了两种解决方法：手动添加MySQL JDBC驱动程序和通过Maven添加MySQL JDBC驱动程序。最后，通过一个示例展示了如何使用Hibernate连接MySQL数据库，测试Hibernate是否能够正常工作。