Hibernate无法自动生成数据库表问题排查请求

1. 核心配置项核查 #

先确认hibernate.cfg.xml里的关键配置是否生效：

• 必须开启自动建表逻辑：hibernate.hbm2ddl.auto 需设为 create、update 或 create-drop（不能是none或未配置），示例：

<property name="hibernate.hbm2ddl.auto">update</property>

• 数据库连接参数必须匹配你的MySQL实例：

<property name="connection.url">jdbc:mysql://localhost:3306/your_db_name?useSSL=false&serverTimezone=UTC</property>
<property name="connection.driver_class">com.mysql.cj.jdbc.Driver</property>
<property name="connection.username">root</property>
<property name="connection.password">your_pwd</property>

• 强制开启SQL日志输出，确认Hibernate是否执行语句：

<property name="hibernate.show_sql">true</property>
<property name="hibernate.format_sql">true</property>

2. 实体类注解正确性检查 #

每个实体类必须满足JPA/Hibernate的注解要求：

• 类上必须标注@Entity，可选@Table指定表名：

@Entity
@Table(name = "users")
public class User {
    // ...
}

• 必须有主键字段，标注@Id并指定生成策略：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

• 确认实体类被Hibernate扫描到：要么在hibernate.cfg.xml里显式配置<mapping class="com.yourpackage.User"/>，要么（Spring环境下）通过@EntityScan("com.yourpackage")开启包扫描

3. 依赖版本与完整性检查 #

• MySQL驱动版本需和MySQL服务版本匹配：MySQL 8.0+必须用8.x版本驱动，Maven示例：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

• Hibernate核心依赖必须完整，Maven示例：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.6.14.Final</version>
</dependency>

• Spring Boot项目需引入spring-boot-starter-data-jpa，避免单独引入Hibernate导致版本冲突

4. 会话与事务逻辑检查 #

确认代码中正确创建会话、开启并提交事务：

SessionFactory sessionFactory = new Configuration().configure().buildSessionFactory();
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();

session.save(user); // 保存实体
tx.commit(); // 必须提交事务才会触发DDL和DML执行

session.close();
sessionFactory.close();

未开启事务或未提交的情况下，Hibernate不会执行任何数据库操作，自然不会生成表

5. 数据库权限与基础环境检查 #

• 确认数据库账号拥有CREATE权限，否则Hibernate执行建表语句会失败
• 确认指定的数据库已手动创建（MySQL下Hibernate默认不会自动创建数据库）

如果以上步骤排查后仍未解决，可提供完整的hibernate.cfg.xml、实体类代码、依赖配置文件（pom.xml/build.gradle），以便精准定位问题。

内容的提问来源于stack exchange，提问作者P I Y U S H D A S I L A