Hibernate 6.1捕获HibernateException非Throwable子类报错解决

Hibernate中.connection()方法已被废弃，需要将原有调用Connection conn = sessionImpl.connection()替换为合规实现。由于doWork()方法会抛出HibernateException，代码需通过try/catch块包裹，替换后的参考实现如下：

try {
    session.doWork(
        new Work() {
            public void execute(Connection connection) throws SQLException 
            { 
                doSomething(connection); 
            }
        }
    );
} catch (HibernateException e) {
    // 自定义异常处理逻辑
}

在Eclipse中编写上述代码时，出现如下编译报错：

No exception of type HibernateException can be thrown; an exception type must be a subclass of Throwable

根据公开的类继承关系，HibernateException的继承链最终会追溯至Throwable，无法直接定位报错原因，当前使用的hibernate-core版本为6.1.0。

经排查，问题根因为类路径下未引入匹配版本的正确依赖：Hibernate 6.1.0版本中的HibernateException继承自jakarta.persistence.PersistenceException，此前仅在POM中引入了错误的持久化API依赖：

<dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>jakarta.persistence</artifactId>
    <version>2.2.3</version>
</dependency>

需要将上述依赖替换为Hibernate 6适配的Jakarta Persistence API依赖：

<dependency>
    <groupId>jakarta.persistence</groupId>
    <artifactId>jakarta.persistence-api</artifactId>
    <version>3.1.0</version>
</dependency>

添加上述正确依赖、刷新Maven项目配置后，编译报错即可消除。

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