如何通过Hibernate将实体集合属性的默认值保存到数据库

一、@Column(nullable=false未生效的原因 #

@Column(nullable=false) 仅用于告诉Hibernate生成数据库表结构时，给该字段添加NOT NULL约束，它不会在Hibernate持久化数据时自动将null值替换为默认值。当你把myCollection设为null后，Hibernate仍会尝试往数据库插入null值，此时数据库因NOT NULL约束抛出错误，并非这个注解“失效”——它的作用是约束表结构，而非拦截业务代码中的null值。

二、让null时使用DEFAULT值插入的几种方法 #

1. 避免字段被设为null（最简方案） #

你已经给字段初始化了new ArrayList<>()，只要业务代码里不主动把myCollection设为null，就能避免问题。如果必须处理可能的null场景，可以在实体类构造函数中重新初始化，或者给字段的setter方法加判断：

public void setMyCollection(Collection<MyEnum> myCollection) {
    this.myCollection = myCollection == null ? new ArrayList<>(Arrays.asList(MyEnum.V1, MyEnum.V2)) : myCollection;
}

2. 使用@DynamicInsert注解 #

在实体类上添加@DynamicInsert，这个注解会让Hibernate生成INSERT语句时只包含非null的字段。当myCollection为null时，INSERT语句里不会出现该字段，数据库会自动使用你定义的DEFAULT值。
注意：该注解作用于整个实体，插入时所有null字段都会被忽略，转而使用列默认值。

3. 用JPA生命周期注解拦截null值 #

在实体类中添加一个方法，用@PrePersist和@PreUpdate注解标记，在持久化或更新前检查字段是否为null，手动设置默认值：

@PrePersist
@PreUpdate
private void setDefaultMyCollection() {
    if (myCollection == null) {
        myCollection = new ArrayList<>(Arrays.asList(MyEnum.V1, MyEnum.V2));
    }
}

这样无论业务代码是否将字段设为null，Hibernate在持久化前都会自动把null替换为默认集合。

4. 调整字段注解配置 #

确保@ColumnDefinition中明确包含NOT NULL和DEFAULT规则，同时结合@DynamicInsert使用：

@Type(type = "jsonb")
@ColumnDefault("'[\"V1\",\"V2\"]'")
@Column(columnDefinition = "jsonb NOT NULL DEFAULT '[\"V1\",\"V2\"]'", nullable = false)
private Collection<MyEnum> myCollection = new ArrayList<>();

这里nullable=false和columnDefinition里的NOT NULL属于重复配置，不影响功能，核心是确保数据库列的约束和默认值定义正确，再配合@DynamicInsert让null场景下不插入该字段，触发默认值生效。

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