
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 配置应补充该关键属性:
完整示例(含脚本导出 + 数据库执行):
⚠️ 注意事项:
- 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 就如同写了建表语句却忘了按回车——脚本有了,但数据库仍是空的。










