Hibernate共享主键单向关联在不同版本中的不一致行为排查

问题背景 #

采用共享主键的一对一关联模型（employee为主表，employee_metadata通过主键外键关联employee），测试在Hibernate 5.3.20.Final中正常运行，但升级到5.3.21.Final及更高版本后，执行保存操作时抛出外键约束违反异常，提示employee_metadata的主键不存在于employee表中。

根因 #

Hibernate 5.3.21中修复了HHH-12842问题，调整了关联实体的持久化顺序逻辑：旧版本中Hibernate会优先持久化主实体Employee，再处理关联的EmployeeMetadata；新版本中持久化顺序反转，导致employee_metadata先插入数据库，此时employee还未被保存，触发外键约束检查失败。

可行解决方案 #

方案1：优化实体关联注解（推荐） #

通过双向关联+@MapsId明确主从关系，让Hibernate正确识别持久化顺序：
修改Employee实体：

@Entity
@Data
public class Employee {
    @Id
    private UUID id;

    private String empName;

    // 指定由EmployeeMetadata维护关联关系
    @OneToOne(cascade = CascadeType.ALL, mappedBy = "employee")
    private EmployeeMetadata employeeMetadata;

    public void setEmployeeMetadata(EmployeeMetadata employeeMetadata) {
        this.employeeMetadata = employeeMetadata;
        employeeMetadata.setId(this.id);
        employeeMetadata.setEmployee(this); // 建立双向关联
    }
}

修改EmployeeMetadata实体，添加反向关联并复用主键：

@Entity(name = "employee_metadata")
@Data
public class EmployeeMetadata {
    @Id
    private UUID id;

    private String address;

    // @MapsId 表示复用关联实体的主键作为自身主键
    @OneToOne
    @MapsId
    @JoinColumn(name = "id")
    private Employee employee;
}

这种方式让Hibernate明确Employee是主实体，会优先插入主表数据，再插入关联表，从根源避免外键约束问题。

方案2：手动控制保存顺序 #

如果不想修改实体结构，可以在业务层调整保存顺序，先保存Employee再保存EmployeeMetadata（注意需移除CascadeType.ALL或调整级联策略，避免自动触发关联保存）：

public void createEmployee(Employee employee) {
    // 先保存主实体
    employeeRepository.save(employee);
    // 再保存关联元数据
    EmployeeMetadata metadata = employee.getEmployeeMetadata();
    if (metadata != null) {
        employeeMetadataRepository.save(metadata);
    }
}

此方案简单直接，但会破坏级联操作的便利性，适合临时修复场景。

方案3：调整数据库外键约束（不推荐） #

将PostgreSQL的外键约束设置为延迟检查，让数据库在事务提交时再验证外键：

ALTER TABLE employee_metadata
    DROP CONSTRAINT fk_employee_metadata_id_employee_id;

ALTER TABLE employee_metadata
    ADD CONSTRAINT fk_employee_metadata_id_employee_id
        FOREIGN KEY (id) REFERENCES employee(id) ON DELETE CASCADE
        DEFERRABLE INITIALLY DEFERRED;

这种方式绕过了Hibernate的持久化顺序问题，但会降低数据库的实时约束检查能力，仅在无法修改代码时临时使用。

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