Spring双向OneToOne关联：主控端无法持久化关联关系求助

实体映射配置错误 #

你的实体注解存在冲突，导致Hibernate无法正确识别共享主键关联关系，调整如下：

Document 类 #

public class Document {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 主控方，级联所有操作，明确主键关联字段
    @OneToOne(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    @PrimaryKeyJoinColumn(name = "id", referencedColumnName = "document_id")
    private Invoice invoice;

    // Getter、Setter
}

Invoice 类 #

public class Invoice {
    @Id
    @Column(name = "document_id")
    private Long id;

    // 从控方，@MapsId指定复用关联Document的主键
    @OneToOne(fetch = FetchType.LAZY)
    @MapsId
    @JoinColumn(name = "document_id")
    private Document document;

    // Getter、Setter
}

关键修正：移除Invoice中冗余的documentId属性，直接用id映射数据库的document_id字段，@MapsId会自动同步关联Document的主键值，避免属性名混淆导致的映射失效。

服务层保存逻辑调整 #

原逻辑中先保存Invoice再关联Document，会导致Hibernate持久化上下文状态不一致，关联关系无法同步到数据库。利用Document的级联配置优化：

// 映射Invoice并关联已存在的Document
Invoice newInvoice = invoiceMapper.fromDto(dto);
newInvoice.setDocument(document);
// 通过主控方Document保存，级联完成Invoice的持久化与关联维护
document.setInvoice(newInvoice);
documentRepository.save(document);

说明：由于Document配置了CascadeType.ALL，保存Document时会自动同步关联的Invoice，无需单独调用invoiceRepository.save()。

MapStruct 映射修复 #

解决"attempted to assign id from null one-to-one property"异常，调整映射器：

@Mapper(componentModel = "spring", nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE, uses = {DocumentService.class})
public interface InvoiceMapper {

    @BeanMapping(ignoreByDefault = true)
    // 从DTO的documentId字段映射到Invoice的document实体（通过DocumentService自动查询）
    @Mapping(source = "documentId", target = "document")
    Invoice fromDto(Dto dto);
}

注意：确保DTO中包含documentId字段，MapStruct会通过DocumentService自动获取对应的Document实体，避免手动映射时出现空关联。

额外排查点 #

• 检查数据库Invoice表的document_id字段是否为主键，且与Document表的id字段建立外键关联；
• 开启Hibernate SQL日志（spring.jpa.show-sql=true），查看执行的SQL语句，确认关联字段是否被正确更新；
• 避免在双向关联中同时手动维护双方关系，优先通过主控方（Document）操作保证状态一致。

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