
hibernate 6+ 中使用 jpa 标准 ddl 生成配置时,仅设置脚本导出属性(如 `scripts.create-target`)不会自动执行建表操作;必须显式启用数据库端的 schema action(如 `database.action=create`),否则 sql 文件生成成功但数据库中无实际表结构。
在 Hibernate 6.1 及更高版本中,JPA 规范(JSR 338 / Jakarta Persistence 3.0+)已将 DDL 生成机制标准化,不再依赖 Hibernate 专属的 hibernate.hbm2ddl.auto 属性。取而代之的是 jakarta.persistence.schema-generation.* 系列属性,它们分为两类职责:
- 脚本生成(Script-based):控制 .sql 文件的生成(如 scripts.action, scripts.create-target);
- 数据库执行(Database-based):控制是否在启动时直接操作数据库(如 database.action, database.create-source)。
你遇到的问题根源在于:当前配置仅启用了脚本生成(scripts.action=create + scripts.create-target=tables.sql),但未启用数据库端的 schema 操作,因此 Hibernate 仅将 DDL 写入 tables.sql 文件,而不会连接数据库执行 CREATE TABLE 语句。
✅ 正确的 JPA 标准配置应同时包含脚本与数据库双路径(按需选择):
? 补充说明:
- database.action 可选值包括:none(默认,不操作)、create、drop-and-create、drop、validate、update(⚠️ 注意:update 在 Hibernate 6+ 中已被移除,不再支持,避免误用);
- create-source 推荐设为 metadata(基于实体注解),也可设为 script(配合 scripts.create-source 指向 SQL 文件);
- 若仅需生成 SQL 脚本而不触碰数据库(如 CI/CD 环境导出 DDL),则保持 database.action=none(显式声明更安全);
- hibernate.hbm2ddl.auto 在纯 JPA 模式下应完全弃用,因其属于 Hibernate 实现细节,与 JPA 规范冲突,且在 Hibernate 6+ 中行为受限(例如 update 已废弃)。
? 最佳实践建议:
开发阶段可启用 database.action=create 快速验证模型;生产环境务必禁用(none),改用受控的迁移工具(如 Flyway 或 Liquibase)管理 schema 变更,确保可追溯性与安全性。
总结:JPA 标准 DDL 配置是“分治式”的——脚本输出 ≠ 数据库执行。缺一不可的两个核心属性是:
jakarta.persistence.schema-generation.scripts.action(决定是否写文件)
和
jakarta.persistence.schema-generation.database.action(决定是否连库执行)。
补全后者,问题即解。










