Quarkus Reactive Hibernate复合键下一对一映射失效问题

问题核心 #

从Spring Data+Hibernate迁移到Quarkus Panache(v2.16.2)+Reactive Hibernate后，带一对一关联的复合键实体查询时出现反射访问私有字段失败的错误，报错指向AssociatedAccountCompositeId的customerAccountId字段。

关键原因 #

1. Kotlin默认将val/var生成私有字段，Reactive Hibernate反射访问私有字段时受限；
2. 实体继承的泛型类型不匹配，导致Hibernate处理实体ID时出现类型混淆；
3. 复合键类未开放（非open），无法生成Hibernate代理类。

分步解决方案 #

1. 修正实体继承的泛型类型 #

AssociatedAccountEntity的泛型参数应与自身ID的非空类型保持一致，原代码中泛型用了可空类型，导致ID处理逻辑混乱：

@Entity
@Table(name = "account_assoc")
class AssociatedAccountEntity(
    @EmbeddedId
    override val id: AssociatedAccountCompositeId,
    @OneToOne
    @JoinColumn(name = "promotion_code_id", insertable = false, updatable = false)
    val promotionCode: PromotionCodeEntity
) : BaseEntity<AssociatedAccountCompositeId>() // 移除泛型的可空标记

2. 为复合键字段添加@JvmField注解 #

让Kotlin直接生成公开字段，避免Hibernate反射访问私有字段被限制：

@Embeddable
open class AssociatedAccountCompositeId(
    @JvmField
    @Column(name = "customer_account_id")
    val customerAccountId: String,
    @JvmField
    @Column(name = "promotion_code_id")
    val promotionCodeId: Long
) : Serializable {
    companion object {
        private const val serialVersionUID: Long = 845208461728L
    }

    // 其余equals、hashCode、toString代码不变
}

3. 标记复合键类为open #

Quarkus Reactive Hibernate需要为实体/嵌入类生成代理，因此类必须是开放的：

@Embeddable
open class AssociatedAccountCompositeId( // 添加open关键字
    // ... 字段代码不变
) : Serializable {
    // ... 其余代码不变
}

4. 调整一对一关联映射（可选） #

若上述修改后仍有问题，可尝试调整关联的加载策略，避免关联初始化时的反射冲突：

@Entity
@Table(name = "promotion_code")
class PromotionCodeEntity(
    @OneToOne(mappedBy = "promotionCode", fetch = FetchType.LAZY)
    var associatedAccount: AssociatedAccountEntity?
) : BaseEntity<Long>() {
    // ... ID生成代码不变
}

验证 #

修改完成后，调用PromotionCodeEntity.findAll().list()即可正常查询，不再出现反射访问字段的错误。

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