使用Hibernate+Kotlin时一对一关联未生成外键问题

场景说明 #

使用Kotlin结合Hibernate开发，数据库表为一对一关联结构：business_trip与prepayment_details一对一关联，prepayment_details表通过business_trip_id字段关联business_trip的id主键。

BusinessTrip实体代码 #

@Entity
@Table(name = "business_trip")
open class BusinessTripEntity(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "ID", nullable = false)
    open var id: Long?,

    @OneToOne(mappedBy = "businessTrip", cascade = [CascadeType.ALL])
    open var prepaymentDetails: PrepaymentDetailsEntity?
)

PrepaymentDetails实体代码 #

@Entity
@Table(name = "prepayment_details")
open class PrepaymentDetailsEntity(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    open var id: Long?,

    @OneToOne(cascade = [CascadeType.ALL])
    @JoinColumn(name = "business_trip_id", referencedColumnName = "id")
    open var businessTrip: BusinessTripEntity?
)

问题 #

插入记录时，prepayment_details表中的business_trip_id外键字段未被正确赋值。

原因 #

在Hibernate的一对一关联规则中，拥有外键的一方（PrepaymentDetailsEntity）是关联关系的维护端，@JoinColumn标注在这一方，负责管理外键字段的更新。如果插入时仅设置BusinessTripEntity.prepaymentDetails，但未反向设置PrepaymentDetailsEntity.businessTrip，Hibernate不会自动维护维护端的关联关系，导致外键字段为空。

解决方案 #

插入时必须双向绑定关联关系，确保维护端的关联引用被正确设置：

// 创建实体实例
val businessTrip = BusinessTripEntity(id = null)
val prepaymentDetails = PrepaymentDetailsEntity(id = null)

// 双向绑定关联
businessTrip.prepaymentDetails = prepaymentDetails
prepaymentDetails.businessTrip = businessTrip

// 保存主实体（因配置了CascadeType.ALL，会级联保存关联的prepaymentDetails）
entityManager.persist(businessTrip)

也可以在实体类中添加辅助方法简化绑定操作，比如在BusinessTripEntity中新增：

fun bindPrepaymentDetails(details: PrepaymentDetailsEntity) {
    this.prepaymentDetails = details
    details.businessTrip = this
}

后续调用时只需执行businessTrip.bindPrepaymentDetails(prepaymentDetails)，即可完成双向关联绑定。

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