Spring JPA一对一关系中父子实体的级联持久化配置

你遇到的错误根源是未正确配置一对一关联的映射关系：缺少级联持久化规则，且CustomerAddress的ID未与Customer的ID正确绑定，导致JPA无法自动生成关联ID，触发外键约束错误。以下是正确的实体配置和使用方式：

正确的实体映射配置 #

Customer 实体 #

@Entity
@Table(name = "customer")
public class Customer {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;

    @Column(name = "name")
    private String name;

    // 一对一关联，级联所有操作，指定关联的反向属性
    @OneToOne(mappedBy = "customer", cascade = CascadeType.ALL, optional = false)
    private CustomerAddress customerAddress;

    // 构造方法、getter/setter
    // 双向绑定关联关系，确保JPA上下文能识别完整关联
    public void setCustomerAddress(CustomerAddress customerAddress) {
        this.customerAddress = customerAddress;
        customerAddress.setCustomer(this);
    }
}

CustomerAddress 实体 #

@Entity
@Table(name = "customer_address")
public class CustomerAddress {
    @Id
    @Column(name = "customer_id")
    private UUID id; // 与Customer的ID完全一致

    @Column(name = "street")
    private String street;

    // 关联Customer，@MapsId将关联对象的ID赋值给当前实体的ID
    @OneToOne
    @MapsId
    @JoinColumn(name = "customer_id")
    private Customer customer;

    // 构造方法、getter/setter
}

关键配置说明 #

• @OneToOne(cascade = CascadeType.ALL)：指定对Customer执行保存、更新、删除等操作时，自动同步到关联的CustomerAddress，实现一次save()操作持久化两个实体。
• @MapsId：让CustomerAddress直接复用关联Customer的ID，无需单独生成主键，完美匹配你表结构中customer_id同时作为主键和外键的设计。
• 双向绑定：在setCustomerAddress方法中同时设置CustomerAddress的customer属性，确保JPA能识别完整的关联关系，避免出现关联对象ID为null的情况。

级联保存示例代码 #

// 创建实体并绑定关联关系
Customer customer = new Customer();
customer.setName("张三");

CustomerAddress address = new CustomerAddress();
address.setStreet("XX街道123号");

customer.setCustomerAddress(address);

// 只需保存Customer，级联保存CustomerAddress
customerRepository.save(customer);

内容的提问来源于stack exchange，提问作者Gustavo Cesário