Spring Boot中JPA实体类@Column注解的default默认值不生效问题

AI 小北

2026-10-1

枚举字段默认值不生效的根本原因

JPA默认生成的INSERT语句会包含实体所有字段，若未显式给language字段赋值，实体中该字段默认值为null，生成的SQL就会显式给language传入null值。数据库DEFAULT约束仅在插入语句未指定该字段时生效，显式传null不会触发默认值逻辑。
保留nullable = false配置时，JPA校验或数据库非空约束会直接拦截null值，抛出ConstraintViolation异常；移除该配置后，null会直接存入数据库，自然不会触发默认值。

可行解决方案

方案1：实体字段初始化默认值（最稳妥）

直接在实体类中给枚举字段设置初始值，完全不依赖数据库层面的约束，INSERT语句会直接携带默认值入库，代码如下：

@Enumerated(EnumType.STRING)
@Column(name = "language", nullable = false)
private Language language = Language.ENGLISH;

方案2：配置动态INSERT走数据库默认值

如果需要依赖数据库的DEFAULT约束，可以通过配置让JPA生成INSERT语句时自动忽略null字段，触发数据库默认值逻辑：

给实体类新增@DynamicInsert注解，开启插入时动态拼接SQL，仅包含非null字段
可使用@ColumnDefault注解替代手写columnDefinition，语义更清晰
修改后完整代码示例：

@Entity
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@DynamicInsert
@Table(name = "employee")
public class Employee{   
  @Id
  private String id;
  
  @Column(name = "name", nullable = false)
  private String name;
  
  @Column(name = "email", nullable = false)
  private String email;
  
  @Column(name = "language", nullable = false)
  @Enumerated(EnumType.STRING)
  @ColumnDefault("'ENGLISH'")
  private Language language;
}