Hibernate 6+Jakarta中InheritanceType.JOINED类转换异常问题

将实体库升级至兼容Hibernate 6.x与Jakarta EE版本后，查询采用InheritanceType.JOINED策略的继承实体时，出现类转换异常：

class com.example.ServiceOrder cannot be cast to class com.example.GoodsOrder (com.example.ServiceOrder and com.example.GoodsOrder are in unnamed module of loader 'app')

测试代码：

factory = Persistence.createEntityManagerFactory("order-persistence-unit");
entityManager = factory.createEntityManager();

final var query = entityManager.createQuery("select serviceOrder from com.example.ServiceOrder serviceOrder where serviceOrder.orderId = :orderId", ServiceOrder.class).setParameter("orderId", 1L);

final var serviceOrder = query.getSingleResult();

实体结构说明：

• 父类Order使用JOINED继承策略，同时持有ServiceOrder和GoodsOrder两个子类的一对一关联
• 子类ServiceOrder继承自Order，通过@PrimaryKeyJoinColumn与父类关联，同时也定义了一个指向父类Order的一对一关联

父类Order核心代码：

@Entity
@Table(name = "Order")
@Inheritance(strategy = InheritanceType.JOINED )
public class Order implements Serializable {
    private Long orderId;
    private GoodsOrder goodsOrder;
    private ServiceOrder serviceOrder;

    @Id
    @GeneratedValue(generator = "com.example.OrderIdGenerator")
    @GenericGenerator(
        name = "com.example.OrderIdGenerator",
        strategy = "org.hibernate.id.IdentityGenerator")
    @Column(name = "ORDER_ID", unique = true, nullable = false)
    public Long getOrderId() { return this.orderId; }

    @OneToOne(fetch = FetchType.LAZY, mappedBy = "order")
    public ServiceOrder getServiceOrder() { return this.serviceOrder; }
    
    // GoodsOrder的关联方法省略
}

子类ServiceOrder核心代码：

@Entity
@Table(name = "SERVICE_ORDER")
@PrimaryKeyJoinColumn(name = "SERVICE_ORDER_ID", referencedColumnName = "ORDER_ID")
public class ServiceOrder extends Order implements Serializable {
    private Order order;

    @OneToOne(fetch = FetchType.LAZY)
    @PrimaryKeyJoinColumn
    public Order getOrder() { return this.order; }
}

关键触发条件：仅当父类同时引用多个子类时才会出现该错误，Hibernate 5.x与javax环境下可正常运行。

1. 移除子类中冗余的父类关联 #

子类ServiceOrder本身继承自Order，已经通过继承关系拥有父类的属性，无需额外定义private Order order的一对一关联。这种冗余关联会导致Hibernate在处理继承映射时出现解析混淆，尤其在Hibernate 6.x对关联逻辑的校验更严格的情况下，直接触发类型转换错误。

修改后的ServiceOrder：

@Entity
@Table(name = "SERVICE_ORDER")
@PrimaryKeyJoinColumn(name = "SERVICE_ORDER_ID", referencedColumnName = "ORDER_ID")
public class ServiceOrder extends Order implements Serializable {
    // 移除private Order order及对应的get/set方法
    // 保留其他业务属性与方法
}

2. 清理父类中的子类反向关联 #

父类中定义的ServiceOrder、GoodsOrder一对一关联属于冗余配置，因为JOINED继承策略下，Hibernate已经通过主键关联维护了父类与子类的关系。如果需要从父类访问子类实例，可通过类型判断或显式查询实现，而非直接定义子类属性。

修改后的Order类：

@Entity
@Table(name = "Order")
@Inheritance(strategy = InheritanceType.JOINED )
public class Order implements Serializable {
    private Long orderId;

    @Id
    @GeneratedValue(generator = "com.example.OrderIdGenerator")
    @GenericGenerator(
        name = "com.example.OrderIdGenerator",
        strategy = "org.hibernate.id.IdentityGenerator")
    @Column(name = "ORDER_ID", unique = true, nullable = false)
    public Long getOrderId() { return this.orderId; }

    // 移除ServiceOrder和GoodsOrder的@OneToOne关联属性及方法
}

若需从父类实例访问具体子类，可使用以下方式：

Order order = entityManager.find(Order.class, 1L);
if (order instanceof ServiceOrder) {
    ServiceOrder serviceOrder = (ServiceOrder) order;
    // 处理业务逻辑
} else if (order instanceof GoodsOrder) {
    GoodsOrder goodsOrder = (GoodsOrder) order;
    // 处理业务逻辑
}

3. 校验主键关联配置 #

确保@PrimaryKeyJoinColumn的配置与数据库表结构完全匹配：

• 子类的name属性对应自身表的主键列，referencedColumnName对应父类表的主键列
• 父类与子类的主键生成策略保持一致，避免主键值不匹配导致的关联错误

Hibernate 6.x对继承映射和关联关系的解析逻辑进行了重构，相比Hibernate 5.x，它对双向关联的一致性要求更严格。当子类继承父类的同时，又显式定义指向父类的一对一关联，再加上父类同时引用多个子类，这种冗余且冲突的配置会导致Hibernate在实例化查询结果时，错误地将子类实例赋值给其他子类的属性，最终触发类转换异常。

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