Hibernate采用TABLE_PER_CLASS继承策略时报hib_sess_id空值NPE

问题背景 #

• 原有基于@MappedSuperclass实现的实体继承结构，因需要将AbstractItem抽象类作为一对多关联的目标类型，必须切换为JPA实体继承模式
• 测试验证：未指定继承策略时应用可正常启动；一旦为抽象父类添加@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)指定按类建表策略，应用启动直接失败
• 调试定位结果：Hibernate构建表结构过程中，hib_sess_id列关联的值类型为null，最终在调用Column.getSqlTypeCode()方法时触发空指针

可复现代码 #

抽象父类定义 #

@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
@Entity
public abstract class AbstractItem {
    /**
     * The specific id of this Item on the server.
     */
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    protected AbstractItem(){}
}

具体子类定义 #

@Entity
public class SimpleItem extends AbstractItem {
    protected SimpleItem(){}
    public SimpleItem() {}
}

仓储层结构 #

// 泛型通用仓储
@NoRepositoryBean
public interface ItemRepository<T extends AbstractItem> extends CrudRepository<T, Long> { }

// 具体子类仓储
@Transactional
public interface SimpleItemRepository extends ItemRepository<SimpleItem>{}

核心异常栈 #

Caused by: java.lang.NullPointerException
    at org.hibernate.mapping.Column.getSqlTypeCode(Column.java:198)
    at org.hibernate.hql.spi.id.AbstractMultiTableBulkIdStrategyImpl.buildIdTableCreateStatement(AbstractMultiTableBulkIdStrategyImpl.java:146)
    at org.hibernate.hql.spi.id.persistent.PersistentTableBulkIdStrategy.buildIdTableInfo(PersistentTableBulkIdStrategyImpl.java:130)
    at org.hibernate.hql.spi.id.persistent.PersistentTableBulkIdStrategy.buildIdTableInfo(PersistentTableBulkIdStrategyImpl.java:43)
    at org.hibernate.hql.spi.id.AbstractMultiTableBulkIdStrategyImpl.prepare(AbstractMultiTableBulkIdStrategyImpl.java:84)
    at org.hibernate.internal.SessionFactoryImpl.<init>(SessionFactoryImpl.java:309)

问题根因 #

该空指针是TABLE_PER_CLASS继承策略与Hibernate默认批量ID操作策略的已知兼容问题：

• Hibernate默认使用PersistentTableBulkIdStrategy处理批量删除、批量更新操作，启动阶段会为整个继承体系构建专门的持久化ID表
• 构建ID表结构时，Hibernate会从实体的主键列读取SQL类型定义，绑定到ID表的hib_sess_id列
• 当主键使用GenerationType.AUTO策略、且底层数据库（如PostgreSQL）采用序列作为主键生成器时，主键列的SQL类型会被延迟绑定，导致构建ID表时读取到的列类型值为null
• 不指定继承策略时默认采用SINGLE_TABLE单表映射模式，不需要构建跨实体的独立批量ID表，因此不会进入触发空指针的代码分支，应用可正常启动

可落地修复方案 #

按需选择以下任意一种方案即可解决问题：

1. 切换批量ID处理策略（改动最小）
   调整Hibernate配置，将默认的持久化表批量ID策略替换为内联ID子句策略，绕开触发空指针的代码分支：

   spring.jpa.properties.hibernate.hql.bulk_id_strategy=org.hibernate.hql.spi.id.inline.InlineIdsOrClauseBulkIdStrategy
   

   该模式无需构建独立的持久化ID表，可完全避开空指针问题。

2. 显式指定主键生成策略
   不依赖GenerationType.AUTO的自动类型推断，直接明确指定主键生成器，确保主键列的SQL类型在启动阶段被正确绑定：

   @Id
   @GeneratedValue(strategy = GenerationType.SEQUENCE)
   private Long id;
   

   调整后Hibernate初始化阶段就会完成主键列的类型绑定，不会在构建批量ID表时出现值类型为null的问题。

3. 升级Hibernate版本
   该问题已在Hibernate 5.4.27及以上版本、6.x全系列版本中被官方修复，升级对应依赖版本即可从根源解决兼容问题。

内容的提问来源于stack exchange，提问作者Matt k.