Quarkus中如何让Panache Reactive启动时建立并校验数据库连接

Quarkus的反应式组件（Hibernate Reactive、Reactive PostgreSQL Client等）默认采用懒加载策略，启动阶段不会主动建立数据库连接，只有第一次触发数据库操作时才会尝试连接，这就是错误端口配置下应用仍能启动的核心原因。要实现启动时校验连接、失败即终止应用，可通过以下几种方式解决：

方法一：利用健康检查强制启动校验 #

1. 确保项目已引入quarkus-smallrye-health依赖
2. 在application.yml中添加如下配置：

   quarkus:
     health:
       startup-probe:
         enabled: true
         fail-fast: true # 启动时健康检查失败直接终止应用
       db:
         enabled: true
         reactive: true # 启用反应式数据库健康检查规则
   

   启动时健康检查会主动验证数据库连接，若配置错误会直接抛出异常并终止应用进程。

方法二：自定义启动连接校验逻辑 #

创建启动观察者类，在应用启动时主动触发数据库连接验证：

import io.quarkus.runtime.StartupEvent;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.event.Observes;
import io.vertx.mutiny.pgclient.PgPool;

@ApplicationScoped
public class DbConnectionChecker {

    // 监听启动事件，主动执行连接校验
    void onApplicationStart(@Observes StartupEvent event, PgPool pgPool) {
        // 执行简单查询验证连接，阻塞等待结果
        pgPool.query("SELECT 1")
            .execute()
            .await().indefinitely(); // 连接失败会直接抛出RuntimeException，终止应用启动
    }
}

该类会在应用启动阶段被触发，通过PgPool执行简单查询强制建立连接，失败则直接终止应用。

方法三：配置Hibernate Reactive连接池初始化 #

通过调整连接池参数，让Hibernate Reactive在启动时创建连接并校验：

quarkus:
  hibernate-reactive:
    connection:
      pool:
        min-size: 1 # 启动时至少初始化1个连接
      validation-query: SELECT 1 # 验证连接有效性的查询语句

设置min-size=1会让连接池在启动阶段创建至少一个连接，配合validation-query可确保连接有效性，若配置错误会在启动时抛出异常。

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