Hibernate结合PostgreSQL无法通过XML创建表问题求助

嘿，我来帮你捋一捋这个问题！你提到参考2016年的教程用最新Hibernate版本，版本适配确实是大概率的坑——毕竟从Hibernate 5到现在的6.x，API、依赖结构甚至配置逻辑都有不少变化。结合你的情况，我给你一步步排查方案：

一、先搞定依赖冲突问题 #

2016年的教程里可能还需要单独引入hibernate-entitymanager，但Hibernate 5.3之后，entitymanager已经合并到hibernate-core里了，现在单独引入反而会导致依赖冲突。另外，Hibernate 6.x全面切换到了Jakarta EE API（替代原来的Java EE），这也是容易踩的点。

修改你的Gradle依赖，精简成这样：

dependencies {
    // 最新版Hibernate Core（包含EntityManager功能）
    implementation 'org.hibernate.orm:hibernate-core:6.4.4.Final'
    // Hibernate Validator要和Core版本适配，这里用8.x对应Hibernate 6.x
    implementation 'org.hibernate.validator:hibernate-validator:8.0.1.Final'
    // PostgreSQL驱动
    implementation 'org.postgresql:postgresql:42.7.3'
    // 如果用JPA注解，引入Jakarta Persistence API（替代原来的javax.persistence）
    implementation 'jakarta.persistence:jakarta.persistence-api:3.2.0'
}

⚠️ 注意：如果你的实体类用的是javax.persistence.*的注解，必须全部改成jakarta.persistence.*，否则Hibernate 6.x会识别不到实体！

二、检查Hibernate配置文件的关键项 #

你的XML配置可能因为版本太旧导致不生效，重点检查这几个核心配置：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
        "https://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
    <session-factory>
        <!-- 数据库连接：确认URL、用户名、密码正确，数据库已手动创建 -->
        <property name="hibernate.connection.driver_class">org.postgresql.Driver</property>
        <property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/你的数据库名</property>
        <property name="hibernate.connection.username">postgres</property>
        <property name="hibernate.connection.password">你的密码</property>

        <!-- 自动建表核心配置：必须设置为create/update/create-drop，不能是none或不配置 -->
        <property name="hibernate.hbm2ddl.auto">create</property>
        <!-- 开启SQL打印，方便排查是否生成建表语句 -->
        <property name="hibernate.show_sql">true</property>
        <property name="hibernate.format_sql">true</property>

        <!-- 方言：Hibernate 6.x依然支持PostgreSQLDialect，也可以用对应版本的方言比如PostgreSQL10Dialect -->
        <property name="hibernate.dialect">org.hibernate.dialect.PostgreSQLDialect</property>

        <!-- 关键！必须引入你的实体类/映射文件，否则Hibernate找不到要建表的对象 -->
        <mapping class="com.你的包名.你的实体类"/> <!-- 注解式实体 -->
        <!-- <mapping resource="com/你的包名/你的实体映射.xml"/> 如果是XML映射 -->
    </session-factory>
</hibernate-configuration>

⚠️ 重要提醒：PostgreSQL需要手动先创建数据库，Hibernate只会在已存在的数据库里建表，不会帮你创建数据库本身！

三、确认Main类正确初始化Hibernate #

如果你的Main类只是空启动，没有初始化Hibernate的核心工厂，那Hibernate根本没运行，自然不会建表。确保代码里有这段初始化逻辑：

import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;

public class Main {
    public static void main(String[] args) {
        // 用try-with-resources自动关闭SessionFactory
        try (SessionFactory sessionFactory = new Configuration().configure().buildSessionFactory()) {
            System.out.println("Hibernate SessionFactory 初始化成功！");
            // 此时查看控制台，应该能看到建表的SQL语句输出
        } catch (Exception e) {
            // 之前没报错可能是异常被吞了，这里打印完整异常栈
            e.printStackTrace();
        }
    }
}

四、开启日志排查隐性问题 #

如果上面几步都做了还是没反应，那就开日志看Hibernate的内部执行情况。添加Logback依赖到Gradle：

implementation 'ch.qos.logback:logback-classic:1.4.11'

然后在src/main/resources下创建logback.xml：

<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 专门打印DDL生成和执行的日志 -->
    <logger name="org.hibernate.tool.hbm2ddl" level="DEBUG"/>
    <!-- 打印所有SQL语句 -->
    <logger name="org.hibernate.SQL" level="DEBUG"/>

    <root level="info">
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>

启动后查看控制台日志，就能清楚看到Hibernate是否生成了建表语句，有没有执行成功，或者有没有隐藏的错误（比如权限不足、字段类型不兼容等）。

最后总结 #

你遇到的问题大概率是版本适配+配置遗漏导致的：

1. 旧教程的依赖结构不兼容最新Hibernate；
2. 实体类注解可能还是旧的javax包，Hibernate 6识别不到；
3. 配置文件里没正确引入实体，或者自动建表参数没设置；
4. Main类没初始化Hibernate核心工厂。

按上面的步骤一步步排查，应该就能解决问题了！

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