基于Hibernate的Java Web应用无法从MySQL数据库展示数据

看起来你遇到的ExceptionInInitializerError是典型的Hibernate SessionFactory初始化失败问题——这个错误通常发生在静态代码块或者初始化SessionFactory的静态方法中（也就是你代码里的HibernateUtil.buildSessionFactory方法）。下面是一步步排查和解决的思路：

1. 先找真正的根源异常 #

你提供的错误栈被截断了，ExceptionInInitializerError只是一个包装异常，真正的问题藏在它的cause里。建议你在HibernateUtil的异常处理里加上打印根源异常的代码：

catch (Exception e) {
    System.err.println("SessionFactory构建失败: ");
    e.printStackTrace();
    // 打印根源异常
    if (e.getCause() != null) {
        System.err.println("根源异常: ");
        e.getCause().printStackTrace();
    }
    if (registry != null) {
        StandardServiceRegistryBuilder.destroy(registry);
    }
}

找到Caused by:开头的异常信息，这才是定位问题的关键。

2. 检查Hibernate配置文件（hibernate.cfg.xml） #

最常见的问题都在这里：

• 数据库连接参数错误：确认URL、用户名、密码是否正确。MySQL 8+的URL需要指定时区，比如：

  <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/your_db_name?useSSL=false&serverTimezone=UTC</property>
  

• 方言配置不匹配：根据你的MySQL版本选择正确的方言，比如MySQL 8.x用org.hibernate.dialect.MySQL8Dialect，5.x用org.hibernate.dialect.MySQL5Dialect。
• 映射文件/实体类未正确引入：如果用注解方式，确保<mapping class="com.entity.YourEntity"/>的类路径正确；如果用XML映射，检查<mapping resource="com/entity/YourEntity.hbm.xml"/>的路径是否拼写错误。

3. 检查HibernateUtil的实现是否过时 #

Hibernate 5+已经废弃了旧的Configuration.buildSessionFactory()方法，如果你还用的是老写法，很容易出问题。推荐用标准的新写法：

import org.hibernate.SessionFactory;
import org.hibernate.boot.Metadata;
import org.hibernate.boot.MetadataSources;
import org.hibernate.boot.registry.StandardServiceRegistry;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;

public class HibernateUtil {
    private static StandardServiceRegistry registry;
    private static SessionFactory sessionFactory;

    public static SessionFactory getSessionFactory() {
        if (sessionFactory == null) {
            try {
                // 构建服务注册器
                registry = new StandardServiceRegistryBuilder()
                        .configure() // 默认读取src/main/resources/hibernate.cfg.xml
                        .build();

                // 构建元数据
                Metadata metadata = new MetadataSources(registry)
                        .getMetadataBuilder()
                        .build();

                // 构建SessionFactory
                sessionFactory = metadata.getSessionFactoryBuilder().build();

            } catch (Exception e) {
                e.printStackTrace();
                if (registry != null) {
                    StandardServiceRegistryBuilder.destroy(registry);
                }
            }
        }
        return sessionFactory;
    }

    // 关闭SessionFactory和注册器
    public static void shutdown() {
        if (registry != null) {
            StandardServiceRegistryBuilder.destroy(registry);
        }
    }
}

4. 确认依赖版本匹配 #

Hibernate和MySQL驱动的版本不兼容也会导致初始化失败：

• 如果用Hibernate 5.6.x，搭配MySQL Connector/J 8.0.x是最稳妥的；
• 如果是Maven项目，检查pom.xml里的依赖是否正确：

  <!-- Hibernate核心依赖 -->
  <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>5.6.14.Final</version>
  </dependency>
  <!-- MySQL驱动 -->
  <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.33</version>
  </dependency>
  

5. 检查实体类的映射正确性 #

• 实体类是否添加了@Entity注解？
• 主键字段是否添加了@Id注解？
• 字段的@Column注解是否和数据库表的字段名、类型匹配？比如数据库里是varchar(50)，实体类里用String类型是对的，但如果用Integer就会出错。

如果按照上面的步骤排查后还是解决不了，建议把完整的错误栈（包括Caused by部分）和你的hibernate.cfg.xml、实体类代码贴出来，这样更容易定位问题。

内容的提问来源于stack exchange，提问作者user8705895