
hibernate 自 5.6 版本起已明确放弃对已有列的结构变更(如 `nullable`、`columndefinition`、默认值等)的自动 ddl 支持,仅保留新增列能力;生产环境必须依赖 flyway/liquibase 等专业迁移工具完成 schema 演进。
在 Hibernate 5.6.14.Final(及后续版本)中,hibernate.hbm2ddl.auto(或 Spring Boot 的 spring.jpa.hibernate.ddl-auto)的行为发生了关键性收敛:其 DDL 生成逻辑(见 Table.java#L432)仅检测并执行“列缺失”场景下的 ADD COLUMN 操作,而对已存在列的任何结构性修改——包括:
- 修改 nullable = false(添加 NOT NULL 约束)
- 设置 columnDefinition = "int DEFAULT 1"(添加默认值)
- 更改列类型、长度、唯一性约束等
——均被完全忽略。这并非 Bug,而是 Hibernate 官方的主动设计决策:自 Hibernate 3.2 起,该机制就从未真正支持安全可靠的列级 ALTER 操作;5.6+ 版本只是更彻底地移除了“伪支持”,回归本质——DDL 工具仅用于原型开发与测试环境的快速建表,绝不适用于生产环境的 schema 演进。
例如,以下变更在启动时不会触发任何 ALTER TABLE ... MODIFY COLUMN 或 ALTER TABLE ... ALTER COLUMN SET DEFAULT 语句:
// 初始状态(已存在列)
@Column(name = "visible_type_test")
private VisibleType visibleTypeTest = VisibleType.VISIBLE;
// 更新后(期望生效但实际无效)
@Column(
name = "visible_type_test",
columnDefinition = "INTEGER DEFAULT 1", // ← 不会为现有行设默认值
nullable = false // ← 不会添加 NOT NULL 约束
)
private VisibleType visibleTypeTest = VisibleType.VISIBLE;✅ 正确做法:交由 Flyway 管理
既然你已在使用 Flyway,应严格遵循其工作流:
- 禁止依赖 ddl-auto=update(该模式在 Hibernate 5.6+ 中已被标记为“不推荐且功能受限”);
- 手动编写 SQL 迁移脚本(如 V2__add_not_null_and_default.sql):
-- 先为历史数据填充默认值(避免 NOT NULL 失败) UPDATE your_table SET visible_type_test = 1 WHERE visible_type_test IS NULL; -- 添加默认值(新插入行生效) ALTER TABLE your_table ALTER COLUMN visible_type_test SET DEFAULT 1; -- 添加非空约束 ALTER TABLE your_table ALTER COLUMN visible_type_test SET NOT NULL;
- 提交迁移并重启应用。
⚠️ 注意事项:
- @DynamicUpdate 与 ddl-auto 无关,移除它不会影响 DDL 行为;
- ddl-auto=none 是生产环境唯一推荐配置,强制解除 Hibernate 对 schema 的控制权;
- 即使回退到旧版 Hibernate(如 3.2),其 update 模式也从不保证列修改的安全性——它可能静默失败、跳过变更,或在不同数据库上行为不一致。
总结:这不是你的配置错误,而是 Hibernate 主动剥离了不稳定的自动化 DDL 能力。拥抱 Flyway 的显式、可审计、可回滚的迁移哲学,才是现代 Java 应用数据库演进的正确路径。










