使用Quarkus初始化数据库报错：未找到当前Vertx上下文

错误原因 #

No current Vertx context found 报错的核心原因是：Hibernate Reactive的所有操作必须在Vertx上下文环境中执行，你的初始化代码存在以下问题导致脱离了上下文：

1. 手动调用.subscribe()，跳过了Quarkus的Reactive上下文管理机制
2. 方法返回null而非有效的Uni实例，导致Quarkus无法跟踪和管理Reactive流的执行上下文
3. 分支逻辑中返回null，破坏了Reactive流的完整性

修正后的代码 #

@ApplicationScoped
public class LifecycleBean {

    @Startup
    public Uni<Void> initialize() {
        return initDefaultUserGroup();
    }

    private Uni<Void> initDefaultUserGroup() {
        Log.info("------------- init DefaultUserGroup -------------");
        // 构建完整的Uni操作链，不手动subscribe
        return UserGroup.count("select count(id) from UserGroup where userGroupType = 'ADMIN'")
                .onItem().transformToUni(count -> {
                    if (count == 0) {
                        UserGroup userGroup = new UserGroup();
                        userGroup.userGroupType = UserGroup.UserGroupType.ADMIN;
                        return UserGroup.persist(userGroup).replaceWithVoid();
                    } else if (count > 1) {
                        // 用Uni的失败机制抛出异常，而非直接throw
                        return Uni.createFrom().failure(new RuntimeException("admin group count is greater than 1 !"));
                    }
                    // 返回空的成功Uni，而非null
                    return Uni.createFrom().voidItem();
                });
    }
}

关键修改点说明 #

• 移除手动.subscribe()：Quarkus会自动处理Reactive流的订阅和上下文绑定，手动订阅会让操作脱离Vertx上下文
• 返回完整的Uni链：整个初始化逻辑必须封装成一个连续的Uni流，让Quarkus能在正确的Vertx上下文中执行所有数据库操作
• 替换null返回值：用Uni.createFrom().voidItem()表示无返回值的成功操作，用Uni.createFrom().failure()抛出异常，保证Reactive流的完整性
• 避免直接抛出RuntimeException：在Reactive逻辑中，通过Uni的failure方法抛出异常，才能被Quarkus的Reactive错误处理机制正确捕获

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