Quarkus/Kotlin/Gradle项目集成Hibernate Reactive Panache时出现javax.transaction.TransactionManager Bean未找到错误

看起来你踩了Quarkus响应式Hibernate配置的典型坑——混用了传统Hibernate ORM和Reactive的配置，加上实体类ID的小问题，导致容器找不到响应式事务管理器。下面一步步帮你解决：

1. 修正application.properties配置（核心问题） #

你当前的配置里混用了quarkus.hibernate-orm.*（传统Hibernate属性）和响应式数据源配置，但Hibernate Reactive完全不使用quarkus.hibernate-orm前缀的属性，这会让Quarkus错误地尝试加载传统JTA事务管理器，而响应式场景下需要的是Reactive事务支持。

把你的配置替换成纯Reactive版本：

quarkus.datasource.db-kind=postgresql
quarkus.datasource.username=test
quarkus.datasource.password=test
# 替换Hibernate ORM配置为Reactive专属属性
quarkus.hibernate-reactive.database.generation=drop-and-create
quarkus.hibernate-reactive.log.sql=true
quarkus.hibernate-reactive.sql-load-script=import.sql
quarkus.datasource.reactive.url=postgresql://localhost:5432/test

2. 修复实体类的ID字段 #

你的Incident实体用了String类型的ID，但默认的@GeneratedValue没有合适的生成策略，Hibernate不知道怎么生成String类型的ID值。你有两个选项：

选项A：使用UUID生成String ID #

import javax.persistence.*
import com.fasterxml.jackson.annotation.JsonProperty
import org.hibernate.annotations.GenericGenerator

@Entity
data class Incident(
    @Id
    @GeneratedValue(generator = "UUID")
    @GenericGenerator(name = "UUID", strategy = "org.hibernate.id.UUIDGenerator")
    @field:JsonProperty("id")
    val id: String = "", // 给data类一个默认值，避免CDI初始化问题
    @Column(nullable = false)
    @field:JsonProperty("summary")
    val summary: String,
)

选项B：改用Long类型ID（更常规的选择） #

import javax.persistence.*
import com.fasterxml.jackson.annotation.JsonProperty

@Entity
data class Incident(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @field:JsonProperty("id")
    val id: Long? = null, // 允许null，让数据库自增生成
    @Column(nullable = false)
    @field:JsonProperty("summary")
    val summary: String,
)

3. 验证依赖配置 #

检查你的Gradle依赖，确保没有引入quarkus-hibernate-orm（传统ORM依赖），只保留响应式相关的：

dependencies {
    implementation(enforcedPlatform("io.quarkus:quarkus-bom:1.13.6.Final"))
    implementation("io.quarkus:quarkus-kotlin")
    implementation("io.quarkus:quarkus-arc")
    implementation("io.quarkus:quarkus-hibernate-reactive-panache")
    implementation("io.quarkus:quarkus-reactive-pg-client")
    implementation("io.quarkus:quarkus-resteasy-reactive-jackson")
    implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8")
    testImplementation("io.quarkus:quarkus-junit5")
}

为什么这样能解决问题？ #

• 修正配置后，Quarkus会正确加载Hibernate Reactive的事务支持组件，而不是尝试加载传统的JTA TransactionManager，解决UnsatisfiedResolutionException错误。
• 实体ID的生成策略明确后，Hibernate Reactive能正确生成ID值，避免后续可能的持久化错误。
• 那个CDI警告是因为JtaContextProvider的生命周期管理器被错误标记为未使用，修正配置后，Quarkus会正确识别并加载这个bean，警告自然消失。

最后提一句：Quarkus 1.13.6是比较老的版本了，虽然上面的方案能解决你的问题，但如果可能的话，建议升级到较新的稳定版（比如2.x或3.x），能获得更多功能和bug修复。

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