JPA标准模式生成数据库表方法

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《JPA标准模式下如何生成数据库表结构》，这篇文章主要讲到等等知识，如果你对文章相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

Hibernate 6.x 中使用 JPA 标准 DDL 生成配置时，仅设置脚本导出属性无法自动创建数据库表，必须显式指定 `jakarta.persistence.schema-generation.database.action` 才能同步更新数据库。

在 Hibernate 6.1+ 中，JPA 规范定义了一套标准化的 Schema 生成机制（jakarta.persistence.schema-generation.*），它与传统的 Hibernate 原生属性（如 hibernate.hbm2ddl.auto）互不兼容。当您切换到 JPA 标准方式时，脚本生成（.sql 文件输出）和数据库实际执行是两个独立控制的行为——这意味着即使 scripts.create-target 正确生成了 tables.sql，若未启用数据库操作，H2 内存库中依然不会创建任何表。

关键配置项如下：

• jakarta.persistence.schema-generation.scripts.action：控制是否生成 SQL 脚本（none / create / drop-and-create / drop）
• jakarta.persistence.schema-generation.create-source：指定 DDL 源（metadata 表示基于实体注解；script 表示读取外部 SQL 文件）
• jakarta.persistence.schema-generation.scripts.create-target：指定生成的 SQL 文件路径（如 tables.sql）
• ✅ jakarta.persistence.schema-generation.database.action：决定是否对数据库执行操作（none / create / drop-and-create / drop）——该属性默认为 none，即“只生成脚本，不操作数据库”，这正是您遇到问题的根本原因。

✅ 正确的 persistence.xml 配置应补充该关键属性：

<property name="jakarta.persistence.schema-generation.database.action" value="create"/>

完整示例（含脚本导出 + 数据库执行）：

<persistence-unit name="com.whatever.persistence.jpa">
    <properties>
        <property name="jakarta.persistence.jdbc.driver" value="org.h2.Driver"/>
        <property name="jakarta.persistence.jdbc.url" value="jdbc:h2:mem:db1;DB_CLOSE_DELAY=-1"/>
        <property name="jakarta.persistence.jdbc.user" value="sa"/>
        <property name="jakarta.persistence.jdbc.password" value=""/>

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

        <!-- 启用 JPA 标准 DDL 生成 -->
        <property name="jakarta.persistence.schema-generation.scripts.action" value="create"/>
        <property name="jakarta.persistence.schema-generation.create-source" value="metadata"/>
        <property name="jakarta.persistence.schema-generation.scripts.create-target" value="target/tables.sql"/>

        <!-- ✅ 关键：触发数据库实际建表 -->
        <property name="jakarta.persistence.schema-generation.database.action" value="create"/>
    </properties>
</persistence-unit>

⚠️ 注意事项：

• database.action 和 scripts.action 可独立设置（例如：database.action=none + scripts.action=create → 仅导出 SQL；database.action=create + scripts.action=none → 仅建库不写文件）。
• 若同时启用两者，Hibernate 会先执行数据库操作，再生成对应脚本（顺序固定）。
• 使用内存数据库（如 H2）时，请确保应用启动后有至少一次 EntityManagerFactory 初始化（如 Spring Boot 中 spring.jpa.hibernate.ddl-auto 已弃用，应完全依赖 JPA 标准属性）。
• 生产环境强烈建议将 database.action 设为 none，改用 Flyway/Liquibase 管理 Schema 版本，避免运行时自动 DDL 带来的风险。

总结：JPA 标准 DDL 是面向可移植性的设计，其“生成”与“执行”职责分离。遗漏 database.action 就如同写了建表语句却忘了按回车——脚本有了，但数据库仍是空的。

今天关于《JPA标准模式生成数据库表方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！