Quarkus中JPA连接Derby数据库时Hibernate ORM报错求助

核心问题定位 #

你遇到的空指针异常确实是Hibernate Reactive与Hibernate ORM依赖冲突导致的。在Quarkus环境下，这两个扩展不能共存，否则会干扰EntityManagerFactory的初始化流程，触发recordedState为空的异常。

解决方案步骤 #

1. 移除冲突依赖 #

检查项目的依赖配置（Maven的pom.xml或Gradle的build.gradle），删除所有与Hibernate Reactive相关的条目：

• Maven：移除<artifactId>quarkus-hibernate-reactive</artifactId>及配套的Reactive数据源依赖（如quarkus-reactive-datasource）
• Gradle：移除implementation 'io.quarkus:quarkus-hibernate-reactive'等相关依赖

2. 修正Hibernate ORM的Derby配置 #

确保application.properties使用Hibernate ORM的标准配置，Derby示例配置如下：

# 数据源基础配置
quarkus.datasource.db-kind=derby
quarkus.datasource.username=APP
quarkus.datasource.password=APP
quarkus.datasource.jdbc.url=jdbc:derby://localhost:1527/your-db-name;create=true

# Hibernate ORM配置
quarkus.hibernate-orm.database.generation=update
quarkus.hibernate-orm.log.sql=true

3. 替换手动EntityManagerFactory初始化方式 #

在Quarkus中，不要通过Persistence.createEntityManagerFactory()手动创建工厂（你的QueryService.init()第29行正存在此操作），改用依赖注入获取EntityManager：

import jakarta.persistence.EntityManager;
import jakarta.inject.Inject;
import jakarta.enterprise.context.ApplicationScoped;
import java.util.List;

@ApplicationScoped
public class QueryService {
    @Inject
    EntityManager entityManager;

    public List<Course> obtainCourseList() {
        return entityManager.createQuery("SELECT c FROM Course c", Course.class)
                .getResultList();
    }
}

Quarkus会自动管理EntityManager的生命周期，手动初始化会绕过框架的FastBoot初始化流程，引发异常。

4. 清理persistence.xml（可选） #

如果项目中存在persistence.xml，建议直接删除。Quarkus优先读取application.properties配置，手动的persistence.xml会与框架自动配置冲突。

异常原因分析 #

从堆栈信息可以看到，异常触发点在Quarkus的Hibernate ORM初始化逻辑中：

java.lang.NullPointerException: Cannot invoke "io.quarkus.hibernate.orm.runtime.recording.RecordedState.isReactive()" because "recordedState" is null

当Hibernate ORM与Reactive扩展共存时，Quarkus的初始化流程会混乱，无法正确构建recordedState对象，最终导致空指针异常。

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