如何在Hibernate 6中为不同主键类型的实体建模多态关联？

表结构（伪代码） #

conversations
  id bigserial

subscribers
  id serial

asset_categories
  id smallserial

requirements
  id serial
  requireable_type text
  requireable_id bigint

实体类基础与定义 #

映射超类 #

@MappedSuperclass
public abstract class BaseEntity<T extends Serializable> {
  private T id;

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  public T getId() {
    return id;
  }
}

具体实体类 #

Conversation<Long>
Subscriber<Integer>
AssetCategory<Short>
Requirement<Integer>

所有关联目标实体都实现了Requireable接口，尝试用@Any注解实现多态关联：

@Any(fetch = FetchType.LAZY)
@AnyDiscriminator(DiscriminatorType.STRING)
@AnyDiscriminatorValues({
  @AnyDiscriminatorValue(discriminator = "subscriber", entity = Subscriber.class),
  @AnyDiscriminatorValue(discriminator = "conversation", entity = Conversation.class),
  @AnyDiscriminatorValue(discriminator = "asset_category", entity = AssetCategory.class)
})
@AnyKeyJavaClass(Long.class)
@Column(name = "requireable_type")
@JoinColumn(name = "requireable_id")
public Requireable getRequireable() { return requireable; }

执行后仅Conversation能正常关联持久化，其他实体抛出类型转换异常：

java.lang.ClassCastException: class java.lang.Integer cannot be cast to class java.lang.Long (java.lang.Integer and java.lang.Long are in module java.base of loader 'bootstrap')

解决方案 #

问题根源 #

@Any注解的@AnyKeyJavaClass指定了统一的主键类型为Long，但Subscriber主键是Integer、AssetCategory是Short，Hibernate尝试强制转换这些类型时触发异常。

可行方案 #

方案1：自定义CompositeUserType处理多类型主键

放弃@Any注解，通过实现Hibernate的CompositeUserType适配不同主键类型：

• 创建复合值对象封装requireableType和requireableId，用来承载关联的类型与ID信息。
• 实现CompositeUserType接口：在nullSafeGet方法中，根据requireableType判断目标实体类型，将数据库中bigint类型的requireable_id转换为对应实体的主键类型（如Integer、Short）；在nullSafeSet方法中，把不同类型的主键统一转为Long存入数据库。
• 在Requirement实体中用@Type注解指定自定义的CompositeUserType，并映射对应的两个字段。

方案2：统一主键类型（推荐，简化实现）

如果业务允许，将所有关联实体的主键类型统一为Long：

• 修改数据库表：subscribers的id改为bigserial，asset_categories的id改为bigserial。
• 调整实体类：Subscriber、AssetCategory继承BaseEntity<Long>，主键类型改为Long。
• 保留原@Any注解配置，此时所有实体主键类型一致，类型转换异常消失。

方案3：手动维护多态关联

不依赖Hibernate的多态注解，手动管理关联关系：

• 在Requirement实体中分别添加三个@ManyToOne关联字段：private Conversation conversation;、private Subscriber subscriber;、private AssetCategory assetCategory;，设置为懒加载。
• 添加@Column(name = "requireable_type")和@Column(name = "requireable_id")字段，存储关联类型与ID。
• 编写业务逻辑，确保同一时间只有一个关联字段有值，并同步更新requireable_type和requireable_id。
• 提供getRequireable()方法，根据requireable_type返回对应的关联实体。

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