Spring JPA单表继承场景下实体ID类型不匹配异常求助

问题根因 #

该问题核心是Hibernate对泛型父类中嵌入ID的类型解析受类加载顺序影响，与Spring配置逻辑无直接关联：

1. 你的实体继承结构中，顶层泛型父类AggregateRoot用@EmbeddedId标注了泛型类型的ID字段，多个子类分别绑定了不同的ID实现类（DocOneId、DocTwoId等）。受Java泛型类型擦除机制限制，Hibernate在运行时解析元数据时，需要从子类的泛型参数反向推导ID的实际类型。
2. 当类加载顺序不固定时，Hibernate可能优先加载父类元数据，错误将第一个加载的子类的ID类型判定为整个继承结构下所有实体的统一ID类型，就会出现你遇到的ID类型不匹配异常，且报错的实体随类名、类加载顺序动态变化。
3. 不同EntityManager配置下表现不一致的原因：Spring自动配置和自定义配置的实体扫描、类加载顺序存在差异，因此触发的问题表现不同，甚至会出现不同项目下表现完全相反的情况。

解决方案 #

可任选以下一种方案修复：

• 方案1：ID字段下沉声明
  不在顶层泛型父类AggregateRoot中声明@EmbeddedId，将ID字段下沉到Document的各个子类中分别声明，每个子类单独指定自己的ID类型，从根源避免Hibernate跨子类推导泛型类型。
• 方案2：显式指定ID映射
  给每个实体子类添加@AttributeOverride注解，显式指定ID的映射规则，覆盖父类的泛型推导结果，示例如下：

  @Entity
  @DiscriminatorValue("one")
  @AttributeOverride(name = "id", column = @Column(name = "id"))
  public class DocOne extends Document<DocOneId> {
      // 原有业务逻辑保持不变
  }
  

• 方案3：升级Hibernate版本
  升级到Hibernate 6.2及以上版本，该版本对泛型嵌入ID的元数据解析逻辑做了针对性优化，修复了类加载顺序影响ID类型判断的已知问题。

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