Hibernate 6.2迁移：PostgreSQL枚举映射实现方案咨询

核心说明 #

Hibernate 6彻底重构了类型映射机制，不再依赖@TypeDef和自定义EnumType子类，通过内置注解或转换器就能实现PostgreSQL原生枚举的映射，且完全支持命名查询。

方案一：使用@JdbcTypeCode注解（官方推荐） #

这是最简单直接的方式，通过指定JDBC类型代码让Hibernate以PostgreSQL枚举类型处理属性。

1. 实体类代码调整 #

public class MyEntity {
    @Id
    private int id;

    // 关键注解：指定JDBC类型为OTHER，匹配PostgreSQL枚举类型
    @JdbcTypeCode(Types.OTHER)
    private MyEnum myEnum; // 避免使用Java关键字enum作为变量名

    // getter、setter及其他业务方法...
}

2. 枚举类保持原有定义 #

public enum MyEnum {
    ENTRY1,
    ENTRY2
}

3. 命名查询支持 #

命名查询中直接使用枚举常量即可，Hibernate会自动完成类型转换：

@NamedQuery(
    name = "MyEntity.findByEnum",
    query = "SELECT e FROM MyEntity e WHERE e.myEnum = :enumValue"
)

调用查询时直接传入MyEnum.ENTRY1作为参数，无需额外处理。

方案二：自定义AttributeConverter（适配复杂转换逻辑） #

如果需要自定义枚举与数据库列的转换规则（比如用枚举的ordinal值或自定义字符串），可以实现AttributeConverter接口。

1. 实现转换器类 #

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;

// autoApply=true 会自动将转换器应用到所有MyEnum类型的属性
@Converter(autoApply = true)
public class MyEnumConverter implements AttributeConverter<MyEnum, String> {

    @Override
    public String convertToDatabaseColumn(MyEnum attribute) {
        return attribute != null ? attribute.name() : null;
    }

    @Override
    public MyEnum convertToEntityAttribute(String dbData) {
        return dbData != null ? MyEnum.valueOf(dbData) : null;
    }
}

2. 实体类配置（若未开启autoApply） #

public class MyEntity {
    @Id
    private int id;

    @Convert(converter = MyEnumConverter.class)
    @JdbcTypeCode(Types.OTHER) // 必须添加此注解，确保以PostgreSQL枚举类型写入数据库
    private MyEnum myEnum;

    // ...
}

3. 命名查询支持 #

同样直接在查询语句中使用枚举常量，转换器会自动处理双向转换，不影响查询的正常执行。

必要前提 #

确保PostgreSQL数据库中已创建对应枚举类型：

CREATE TYPE my_enum AS ENUM ('ENTRY1', 'ENTRY2');

同时实体类对应的数据库表中，枚举属性的列类型需设置为my_enum（与你创建的枚举类型名一致）。

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