Spring Boot JPA一对一关系：保存时如何强制插入两个实体？

首先咱们得把两个实体的关联配置做扎实，结合你提到的共享主键一对一模式，具体操作如下：

1. 完善Invoice实体的关联配置 #

在你的Invoice类里，添加和InvoiceSequence的双向关联，并设置级联持久化属性，这样保存Invoice时会自动触发InvoiceSequence的插入：

@Entity
@Table(name = "invoices", indexes = {...})
@JsonIgnoreProperties(ignoreUnknown = true)
public class Invoice implements Serializable {
    private static final long serialVersionUID = 1L;
    @GeneratedValue(generator = "uuid")
    @GenericGenerator(name = "uuid", strategy = "uuid2")
    @Id
    private String id;
    
    // 新增一对一关联，cascade = CascadeType.PERSIST 表示保存Invoice时自动保存关联的InvoiceSequence
    // mappedBy = "invoice" 表示由InvoiceSequence端维护关联关系
    @OneToOne(mappedBy = "invoice", cascade = CascadeType.PERSIST, fetch = FetchType.LAZY, optional = false)
    private InvoiceSequence invoiceSequence;
    
    // getter、setter方法...
}

这里optional = false是强制要求Invoice必须关联一个InvoiceSequence，避免出现孤立的发票记录。

2. 配置InvoiceSequence实体的共享主键 #

InvoiceSequence需要和Invoice共享主键，用@MapsId注解实现，代码如下：

@Entity
@Table(name = "invoice_sequence")
public class InvoiceSequence implements Serializable {
    private static final long serialVersionUID = 1L;

    // 和Invoice共享同一个主键值
    @Id
    private String id;

    // 关联到Invoice，@MapsId表示用关联实体的主键作为自身主键
    @OneToOne
    @MapsId
    @JoinColumn(name = "invoice_id", nullable = false)
    private Invoice invoice;
    
    // 其他业务字段...
    
    // getter、setter方法...
}

3. 保存时的业务代码逻辑 #

在业务代码里，只需要创建两个实体并建立双向关联，然后调用Invoice的保存方法即可，JPA会自动同时插入两条记录：

// 创建Invoice实例并设置业务字段
Invoice invoice = new Invoice();
// 设置发票的其他属性，比如金额、客户信息等...

// 创建InvoiceSequence实例并关联到Invoice
InvoiceSequence invoiceSequence = new InvoiceSequence();
invoiceSequence.setInvoice(invoice); // 绑定到发票
invoice.setInvoiceSequence(invoiceSequence); // 双向关联，保证关系完整性

// 调用Repository保存Invoice，级联规则会自动插入InvoiceSequence
invoiceRepository.save(invoice);

关键注意点 #

• CascadeType.PERSIST：只在首次保存时触发级联，如果需要更新、删除也同步操作，可以换成CascadeType.ALL，根据业务需求选择。
• 双向关联必须同时设置两边的引用：如果只设置invoiceSequence.setInvoice(invoice)而不设置invoice.setInvoiceSequence(invoiceSequence)，虽然也能插入，但后续查询关联关系时可能出现数据不一致的问题。
• optional = false和nullable = false：从实体层面强制两个实体必须绑定，避免出现没有对应序列的发票，或者没有对应发票的序列。

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