Hibernate 5迁移至6：枚举类型DiscriminatorColumn兼容问题

针对从Hibernate 5.x迁到6.x后，枚举作为鉴别器类型失效的问题，下面给出两种无需大幅改动原有代码和数据的可行方案：

方案1：明确鉴别器类型与枚举映射匹配 #

Hibernate 6.x对鉴别器的类型一致性检查更严格，5.x的隐式转换逻辑被移除，因此需要明确指定鉴别器类型，并保证枚举字段的序列化规则和鉴别值完全对齐：

1. 修改父类Action的@DiscriminatorColumn注解，显式指定类型为STRING：

@Entity
@DiscriminatorColumn(name = "type", discriminatorType = DiscriminatorType.STRING) // 新增类型指定
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
class Action (

    @Column(name = "type", updatable = false, insertable = false)
    @Enumerated(EnumType.STRING)
    var type: ActionType = ActionType.GENERIC,
    // ... 其他字段
)

2. 子类的@DiscriminatorValue直接用枚举的name()避免硬编码，确保和枚举序列化结果一致：

@Entity
@DiscriminatorValue(ActionType.GENERIC.name)
class GenericAction : Action(ActionType.GENERIC)

@Entity
@DiscriminatorValue(ActionType.BREAK.name)
class BreakAction : Action(ActionType.BREAK)

这个方案让Hibernate明确鉴别器列是字符串类型，同时枚举字段的@Enumerated(EnumType.STRING)会将枚举转换为对应字符串，和鉴别值完全匹配，解决类型对比错误的问题。

方案2：使用Hibernate 6.x专属枚举鉴别器特性 #

如果项目完全基于Hibernate 6.x，可以直接将鉴别器类型设为枚举，进一步简化配置：

1. 父类上指定鉴别器类型为枚举：

@Entity
@DiscriminatorColumn(
    name = "type",
    discriminatorType = DiscriminatorType.ENUM,
    discriminatorOptions = DiscriminatorOptions(force = true)
)
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
class Action (

    @Column(name = "type", updatable = false, insertable = false)
    var type: ActionType = ActionType.GENERIC,
    // ... 其他字段
)

2. 子类直接用枚举常量对应的字符串作为鉴别值：

@Entity
@DiscriminatorValue("GENERIC")
class GenericAction : Action(ActionType.GENERIC)

注意：此方案要求数据库存储的枚举字符串和枚举类的name()完全一致，和现有数据格式匹配，无需修改数据库数据。

为什么之前的尝试有问题？ #

• @DiscriminatorFormula：NativeQuery会绕过Hibernate的鉴别器逻辑，Formula定义的转换不生效，导致查询失败。
• 去掉枚举改字符串：破坏Jackson的JSON序列化逻辑，原有@JsonTypeInfo依赖枚举字段映射子类，改动成本极高。
• @Converter：仅给实体字段加Converter时，Hibernate处理鉴别器不会使用该Converter，仍用默认枚举转换逻辑，导致类型不匹配。

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