Hibernate未设置DEFAULT约束问题排查（PostgreSQL环境）

针对你遇到的问题，从几个常见原因逐一排查：

1. 字段类型映射与columnDefinition不匹配 #

当Java实体字段的类型和columnDefinition指定的数据库类型不匹配时，Hibernate可能会自动调整DDL语句，导致DEFAULT约束被覆盖。比如：

• 若Java字段是Boolean类型，却用columnDefinition = "SMALLINT DEFAULT 1"，Hibernate默认会将Boolean映射为PostgreSQL的boolean类型，此时columnDefinition的设置会被干扰，DEFAULT约束无法生效。
• 解决：确保columnDefinition与Java字段类型完全对应：
  • Boolean类型字段：@Column(columnDefinition = "BOOLEAN DEFAULT true")
  • Integer类型字段：@Column(columnDefinition = "SMALLINT DEFAULT 1")
    避免额外添加@Type注解干扰默认类型映射。

2. 插入操作未触发默认约束逻辑 #

PostgreSQL的DEFAULT约束仅在插入时未指定该字段值或显式使用DEFAULT关键字时才会生效。如果你的代码在插入实体时给enabled字段赋值了null，PostgreSQL会直接插入null，不会触发默认值——这不是PostgreSQL对null的特殊处理，是默认约束的触发规则。

• 检查代码：若插入时enabled被设为null，要么在实体类初始化时给字段设默认值（如private Boolean enabled = true;），要么使用@DynamicInsert注解让Hibernate只插入非null字段，从而触发数据库的DEFAULT约束。

3. Hibernate执行DDL的隐藏问题 #

虽然日志显示建表语句包含DEFAULT约束，但Hibernate的create-drop模式可能存在执行顺序或缓存问题，导致实际DDL未正确应用到PostgreSQL。可以手动将日志中的建表语句复制到PostgreSQL客户端执行，验证是否能生成DEFAULT约束：

• 若手动执行生效，说明是Hibernate执行过程的问题，比如某些版本的Hibernate在处理create-drop时会忽略部分约束；
• 若手动执行也不生效，检查建表语句是否存在语法错误（比如PostgreSQL的BOOLEAN类型不需要加括号，DEFAULT值的写法是否正确）。

4. Hibernate版本兼容性bug #

部分旧版本的Hibernate（如5.x的早期子版本）在处理PostgreSQL的DEFAULT约束时存在解析bug，导致columnDefinition中的DEFAULT设置无法被正确生成到DDL中。尝试升级到稳定版本（如5.6.x或6.x系列），通常能解决这类兼容性问题。

内容的提问来源于stack exchange，提问作者Sergey Zolotarev