Spring Boot整合Hibernate：带@ColumnDefault的字段无法设为非空？

嘿，看你遇到了实体类注解配置默认值但数据库表没生效的问题，我来给你梳理下原因和解决办法！

首先还原下你的场景：
你在Spring Boot项目里用Hibernate定义了这样的实体类：

public class TopicSubscriberMap implements Serializable {
    @ColumnDefault(value="'pending'")
    @Column(nullable=false)
    private String status;
    // 其他字段、构造方法和getter/setter省略
}

但查看MySQL表结构时，发现status字段的默认值并没有被设置成预期的pending：

mysql> desc topic_subscriber_map;
+---------------+--------------+------+-----+---------+-------+
| Field         | Type         | Null | Key | Default | Extra |
+---------------+--------------+------+-----+---------+-------+
| status        | varchar(255) | NO   |     | NULL    |       |
+---------------+--------------+------+-----+---------+-------+

可能的原因和对应的解决步骤 #

• 问题1：Hibernate的表结构更新策略没开对
  如果你的application.properties（或yml）里spring.jpa.hibernate.ddl-auto设置的是none、validate，或者表已经存在时用了update，Hibernate是不会主动修改表字段默认值的。

  • 解决办法：
    • 开发环境可以临时把ddl-auto改成create或者create-drop（注意！这个操作会清空现有表的数据，只适合开发环境测试），重启应用后表会重新生成，默认值应该就生效了。
    • 生产环境千万不要用上面的方式，直接手动执行SQL修改表结构更安全：

      ALTER TABLE topic_subscriber_map MODIFY COLUMN status VARCHAR(255) NOT NULL DEFAULT 'pending';
      

• 问题2：@ColumnDefault的写法有问题
  你给@ColumnDefault传的value="'pending'"多了一层单引号，Hibernate会自动根据字段类型处理字符串的引号，额外加的单引号可能导致解析异常，所以默认值没生效。

  • 解决办法：把注解改成这样就好：

    @ColumnDefault("pending")
    @Column(nullable=false)
    private String status;
    

    改完后配合正确的ddl-auto配置，重新生成表就能看到默认值了。

• 问题3：Hibernate版本太旧
  有些老版本的Hibernate对@ColumnDefault注解的支持不够完善，如果你用的Spring Boot版本比较老，可能会遇到这个问题。建议升级到Spring Boot 2.7及以上的稳定版本（Hibernate版本也会同步更新）。

验证方式 #

改完之后重启应用，再执行desc topic_subscriber_map命令，看看status字段的Default列是不是显示pending就可以啦~

内容的提问来源于stack exchange，提问作者Swapnil Pandey