Quarkus Kotlin中suspend函数触发No current Mutiny.Session异常

问题描述 #

在基于Quarkus Kotlin和Reactive Hibernate with Panache的项目中，给PostRepository里的findByStatusAndTypeAndLanguage函数添加suspend修饰符后，会抛出java.lang.IllegalStateException: No current Mutiny.Session found异常，但仓库内其他带suspend的函数运行正常；移除该函数的suspend修饰后，功能恢复正常。调用链为PostController → PostService → PostRepository，其中Service和Controller层的suspend函数均无异常。

原因分析 #

问题核心在于@WithSession注解与suspend函数的会话绑定逻辑不匹配：

• Reactive Hibernate Panache的@WithSession注解会自动为非挂起函数创建并绑定Mutiny会话，但对于挂起函数，会话上下文无法自动关联到协程执行流程中；
• 其他挂起函数正常的原因：
  • findPostById调用的findById(id)是Reactive Panache为挂起函数适配的方法，能正确关联会话；
  • savePost带有@Transactional注解，事务注解会自动管理会话生命周期，覆盖了@WithSession的逻辑，因此不受影响。

解决方案 #

方案1：给查询函数添加只读事务注解 #

事务注解会自动为挂起函数创建并绑定会话，使用只读事务（TxType.SUPPORTS或TxType.READ_ONLY）不会带来额外性能开销，是最简洁的解决方式：

修改PostRepository中的目标函数：

@ApplicationScoped
@WithSession
class PostRepository : PanacheRepositoryBase<Post, String> {

    // 其他函数保持不变...

    @Transactional(Transactional.TxType.SUPPORTS)
    suspend fun findByStatusAndTypeAndLanguage(
        status: PostStatus,
        type: PostType,
        language: WrittenLanguage,
        page: Int
    ): Uni<List<Post>> {
        val posts: PanacheQuery<Post> =
            find("type = ?1 and status = ?2 and writtenLanguage = ?3", type, status, language)
        return posts
            .page(Page.of(page, 10))
            .list()
    }
}

方案2：手动绑定会话到协程上下文 #

如果不想依赖事务注解，可以通过withSession方法手动包裹查询逻辑，确保会话在协程中可用：

修改后的查询函数：

suspend fun findByStatusAndTypeAndLanguage(
    status: PostStatus,
    type: PostType,
    language: WrittenLanguage,
    page: Int
): Uni<List<Post>> {
    return withSession {
        val posts: PanacheQuery<Post> =
            find("type = ?1 and status = ?2 and writtenLanguage = ?3", type, status, language)
        posts.page(Page.of(page, 10)).list()
    }
}

withSession会返回绑定了会话上下文的Uni，直接返回即可与挂起函数兼容。

方案3：移除suspend修饰符（不推荐） #

移除suspend后，@WithSession会自动为该函数管理会话，功能恢复正常，但会失去协程异步执行的优势，仅作为临时 workaround 使用。

额外注意事项 #

• 可以考虑移除PostService上的@WithSession注解，避免多层会话管理可能带来的冲突；
• 确保使用的Quarkus及Reactive Hibernate Panache版本支持挂起函数的会话绑定，旧版本可能存在兼容性问题。

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