升级Hibernate至6.2.0后枚举列类型验证报错，@Column注解无效

核心问题 #

Hibernate 6.2版本对枚举类型的默认映射策略发生了变更：6.1.x版本中，未显式指定枚举映射方式时，默认将枚举映射为INTEGER类型；但6.2.x版本默认改为将枚举映射为TINYINT类型，而你的数据库表buddies_anonymized中receiving_status列实际为INTEGER类型，导致schema验证失败。

你尝试的@Column(columnDefinition = "INTEGER")无效，是因为该注解仅作用于普通字段的列定义，而枚举类型的映射由Hibernate的EnumType处理器控制，columnDefinition会被枚举的类型逻辑覆盖。

有效解决方案 #

方案1：显式指定枚举映射为整数类型（推荐） #

在枚举字段上添加@Enumerated(EnumType.ORDINAL)，配合指定JDBC类型，确保Hibernate使用整数类型映射：

@Enumerated(EnumType.ORDINAL)
@JdbcTypeCode(Types.INTEGER)
private Status receivingStatus = Status.NOT_REQUESTED;

也可以结合@Column明确列定义：

@Enumerated(EnumType.ORDINAL)
@Column(columnDefinition = "INTEGER")
private Status receivingStatus = Status.NOT_REQUESTED;

方案2：全局配置枚举默认映射类型 #

如果有多个枚举字段需要保持整数映射，可在Hibernate配置中全局设置默认枚举类型：

• Spring Boot项目在application.properties中添加：

hibernate.type.preferred_enum_jdbc_type=INTEGER

• JPA项目在persistence.xml中添加：

<property name="hibernate.type.preferred_enum_jdbc_type" value="INTEGER"/>

方案3：修改数据库列类型（不推荐，除非必要） #

将数据库中buddies_anonymized表的receiving_status列类型改为TINYINT，匹配Hibernate 6.2的默认行为，但此方式需修改数据库结构，可能影响其他依赖该列的代码。

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