Quarkus启动报错：HibernateOrmRuntimeConfig未初始化，求解决方案

问题背景 #

我是Quarkus新手，正在使用Hibernate Reactive with Panache开发应用：

• 部分实体继承PanacheEntity，部分因ID非Long类型继承PanacheEntityBase
• 所有实体均放置于主包下的entities包中
• 依赖清单：
  • quarkus-hibernate-reactive-panache
  • quarkus-reactive-mysql-client
  • quarkus-resteasy-reactive
  • quarkus-arc
  • quarkus-resteasy-reactive-jackson
  • quarkus-junit5
  • rest-assured

错误信息 #

[io.qua.arc.impl] (Quarkus Main Thread) An error occurred during delivery of the @BeforeDestroyed(ApplicationScoped.class) event: javax.enterprise.inject.: Config root [io.quarkus.hibernate.orm.runtime.HibernateOrmRuntimeConfig] with config phase [RUN_TIME] not initialized yet

当前application.properties配置 #

quarkus.datasource.db-kind=mysql
quarkus.hibernate-orm.database.generation=drop-and-create
quarkus.datasource.reactive.url=vertx-reactive:mysql://localhost:3306/my_db
quarkus.datasource.username=root
quarkus.datasource.password=
quarkus.datasource.reactive.name=my_db

原因分析 #

1. 配置适配错误：使用Hibernate Reactive时，误用了传统Hibernate ORM的配置项，导致响应式ORM组件无法正确加载运行时配置
2. 冗余配置干扰：quarkus.datasource.reactive.name属于非必要配置，可能打乱数据源初始化流程
3. 实体扫描隐患：若Quarkus未自动扫描到entities包下的实体类，会导致Hibernate Reactive无法完成ORM元数据初始化

解决办法 #

1. 修正配置文件 #

替换传统ORM配置为Hibernate Reactive专属配置，移除冗余项：

quarkus.datasource.db-kind=mysql
quarkus.datasource.reactive.url=vertx-reactive:mysql://localhost:3306/my_db
quarkus.datasource.username=root
quarkus.datasource.password=
# 替换为响应式ORM的数据库生成策略
quarkus.hibernate-reactive.database.generation=drop-and-create
# 手动指定实体扫描包（自动扫描失效时启用，替换为你的实际包路径）
quarkus.hibernate-reactive.packages=com.yourproject.entities

2. 检查实体类注解 #

继承PanacheEntityBase的实体需手动配置ID字段：

@Entity
public class CustomIdEntity extends PanacheEntityBase {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public String id;
    // 其他业务字段
}

确保所有实体类都添加了@Entity注解，包路径与配置中指定的扫描路径一致。

3. 清理重建项目 #

执行清理命令清除构建缓存，再重启开发模式：

# Maven项目
./mvnw clean install
# Gradle项目
./gradlew clean build

# 重启开发模式
quarkus dev

4. 排查依赖冲突 #

确保项目中未同时引入quarkus-hibernate-orm（阻塞式ORM）与quarkus-hibernate-reactive-panache，两者不可共存。

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