如何使用非主键字段关联JPA/Hibernate的OneToOne实体？

核心配置要点 #

要实现MediaLog与CustomerCase基于caseSystemId的OneToOne关联，需满足两个关键前提：

1. CustomerCase的caseSystemId必须唯一（保证OneToOne关系的合法性）
2. MediaLog必须强制关联有效的CustomerCase（通过JPA约束+数据库外键实现）

实体代码修改 #

1. 调整CustomerCase实体

给caseSystemId添加唯一约束，确保每个caseSystemId仅对应一个CustomerCase：

@Entity
@Audited
class CustomerCase(
    @Id
    var id: UUID = UUID.randomUUID(),
    var authAccountId: UUID,
    @Enumerated(EnumType.STRING)
    var status: CaseStatus,
    @Column(unique = true, nullable = true) // 唯一约束，允许为null（部分CustomerCase无MediaLog）
    var caseSystemId: String? = null,
    // 双向关联可选：添加MediaLog引用
    @OneToOne(mappedBy = "customerCase", fetch = FetchType.LAZY)
    var mediaLog: MediaLog? = null
)

2. 调整MediaLog实体

添加CustomerCase关联字段，配置基于caseSystemId的关联规则，并强制关联有效性：

@Entity
class MediaLog(
    @Id
    var id: UUID = UUID.randomUUID(),
    // 强制关联有效CustomerCase，optional=false确保非空
    @OneToOne(optional = false, fetch = FetchType.LAZY)
    @JoinColumn(
        name = "case_system_id", // 当前实体的关联列名（对应caseSystemId字段）
        referencedColumnName = "case_system_id", // 关联目标实体的列名
        insertable = false, updatable = false // 避免JPA重复操作该字段，由单独的caseSystemId字段维护
    )
    var customerCase: CustomerCase,
    // 显式维护关联字段，与@JoinColumn对应
    @Column(name = "case_system_id", nullable = false)
    var caseSystemId: String,
    var articleSummary: String?,
    var totalArticleCount: Int,
    var resolvedAt: Instant? = null,
    var lastCheckPerformedAt: Instant? = null
)

关键说明 #

• 唯一约束：CustomerCase的caseSystemId必须唯一，否则JPA无法定位唯一关联的实体，这是OneToOne非主键关联的必要条件。
• 强制关联：@OneToOne(optional = false)会在保存MediaLog时校验关联的CustomerCase是否存在，若不存在则抛出JPA异常；同时数据库层面会自动生成外键约束，进一步保证数据完整性。
• 字段维护：设置insertable=false, updatable=false是因为我们单独保留了caseSystemId字段，避免JPA同时通过customerCase和caseSystemId修改同一列导致冲突。若不需要单独维护caseSystemId，可删除该字段，直接通过customerCase.caseSystemId获取值。
• 双向关联：CustomerCase中的mediaLog属性是可选的，用于从CustomerCase端反向查询对应的MediaLog，若不需要双向关联可直接删除该属性。

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