如何适配Hibernate更新后@TypeDef注解的枚举数组转换

问题概述 #

从Hibernate 5.6.12升级到6.4.0后，原通过@TypeDef+EnumArrayType实现的PostgreSQL枚举数组映射失效，旧配置无法正常完成枚举数组与数据库列的转换。

适配方案 #

1. 升级Hypersistence Utils依赖 #

Hibernate 6重构了类型系统，旧版EnumArrayType仅适配Hibernate 5，需切换为支持Hibernate 6的版本。以Maven为例，引入对应依赖：

<dependency>
    <groupId>io.hypersistence</groupId>
    <artifactId>hypersistence-utils-hibernate-60</artifactId>
    <version>3.7.0</version> <!-- 建议使用最新稳定版 -->
</dependency>

2. 调整实体类注解配置 #

Hibernate 6对自定义类型的参数传递和注解使用有调整，修改实体类配置如下：

@TypeDefs({
    @TypeDef(
        name = "host-enum-array",
        typeClass = EnumArrayType.class,
        parameters = {
            @Parameter(name = EnumArrayType.SQL_ARRAY_TYPE, value = "HOST_SERVICES"),
            // 显式指定枚举类全路径，Hibernate 6下需明确配置
            @Parameter(name = EnumArrayType.ENUM_CLASS, value = "com.yourpackage.HostServices")
        }
    )
})
@Entity
public class Host {
    @Type(type = "host-enum-array")
    @Column(
        name = "host_services",
        columnDefinition = "HOST_SERVICES[] NOT NULL DEFAULT '{}'"
    )
    private HostServices[] hostServices;

    // getter、setter及其他字段
}

3. 移除冗余的@ColumnTransformer #

Hibernate 6与新版EnumArrayType已原生支持PostgreSQL枚举数组的读写转换，原@ColumnTransformer的转换逻辑会与新类型处理逻辑冲突，需直接移除该注解。

验证要点 #

• 确认数据库中HOST_SERVICES枚举类型和host_services数组列定义与原配置一致
• 测试CRUD操作，验证枚举数组的读写是否正常完成转换
• 若仍有问题，检查依赖版本是否正确，枚举类的全路径是否准确

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