Quarkus环境@ColumnDefault修饰枚举字段时Hibernate建表报错如何解决

Hibernate无法生成枚举列默认约束的底层原因 #

• @ColumnDefault注解不会自动处理字符串类默认值的引号转义
  你配置的@ColumnDefault("INCOMPLETE")传入的是枚举的字符串值，但Hibernate生成DDL时会直接把该值拼接进字段定义，不会自动为字符串类型的值补充单引号，最终生成的字段定义为status varchar(255) default INCOMPLETE。
  绝大多数关系型数据库要求字符串字面量必须用单引号包裹，没有引号的INCOMPLETE会被识别为数据库关键字/同上下文的字段名，直接抛出语法错误，导致task表创建失败，后续依赖task表的line表外键约束创建自然也会报错。
• 默认枚举映射逻辑不识别数据库原生枚举类型
  @Enumerated(EnumType.STRING)默认是将Java枚举映射为数据库的varchar类型，不会主动适配MySQL、PostgreSQL等数据库的原生枚举类型。如果你使用的是支持原生枚举的数据库，Hibernate默认生成的varchar类型字段，和你预期的枚举类型约束不匹配，也会导致默认值规则不符合数据库要求。

临时方案生效的逻辑 #

你当前采用的写法刚好解决了上述两个问题：

• 手动编写columnDefinition属性，相当于直接指定了DDL生成的完整字段语句，主动补全了枚举类型定义、默认值的单引号、非空约束，生成的DDL完全符合数据库语法要求。
• 主动给实体字段初始化= TaskStatus.INCOMPLETE，避免了Hibernate插入时显式传入null覆盖数据库默认值的问题：Hibernate默认会将实体的null属性显式写入插入SQL，导致数据库侧的默认值不生效，字段初始化后新建实体时该字段默认就有值，同时其他应用直接操作数据库时也能触发数据库侧的默认值约束，覆盖了所有场景。

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