Hibernate保存OneToOne实体顺序错误致外键约束违反问题排查

我在Spring Boot项目中使用Jakarta Persistence API时遇到了问题，对这项技术比较陌生，若问题比较基础还请见谅。

项目实体类简化代码 #

Code实体 #

@Entity
public class Code {
    
    @Id
    @Column(nullable = false, updatable = false, length = 20)
    private String id;
    
    @OneToOne(mappedBy = "itemCode", fetch = FetchType.LAZY)
    private Item codeItem;
    
    // ... 省略其他字段和方法
}

Item实体 #

@Entity
public class Item {
    
    @Id
    @Column(name = "item_code")
    private String itemCode;
    
    @OneToOne(fetch = FetchType.LAZY, cascade = {CascadeType.PERSIST}, optional = false)
    @MapsId
    @JoinColumn(name = "item_code", nullable = false, unique = true)
    private Code code;
    
    @OneToOne(mappedBy = "item", fetch = FetchType.LAZY)
    private SingleItem singleItem;
    
    // ... 省略其他字段和方法
}

SingleItem实体 #

@Entity
public class SingleItem {
    
    @Id
    @Column(name = "item_code")
    private String itemCode;
    
    @OneToOne(fetch = FetchType.LAZY, cascade = {CascadeType.PERSIST}, optional = false)
    @MapsId
    @JoinColumn(name = "item_code", nullable = false, unique = true)
    private Item item;
    
    // ... 省略其他字段和方法
}

遇到的问题 #

场景1：Code不存在时，尝试同时保存SingleItem、Item和Code #

Hibernate会先尝试插入Item，而Item依赖Code，触发外键约束违反：

Hibernate: insert into item (item_code) values (?)
2025-07-28T08:34:45.878+02:00  WARN 16792 --- [backend] [nio-8080-exec-1] o.h.engine.jdbc.spi.SqlExceptionHelper   : SQL Error: 1452, SQLState: 23000
2025-07-28T08:34:45.879+02:00 ERROR 16792 --- [backend] [nio-8080-exec-1] o.h.engine.jdbc.spi.SqlExceptionHelper   : Cannot add or update a child row: a foreign key constraint fails (`testdb`.`item`, CONSTRAINT `FK6k61wsp2ywun4x4d8fag4phhm` FOREIGN KEY (`item_code`) REFERENCES `code` (`id`))

我期望Hibernate能先插入Code，再插入Item和SingleItem。

场景2：使用已存在的Code保存SingleItem时 #

Hibernate仍先插入Item，导致主键重复错误：

Hibernate: insert into Item (item_code) values (?)
Hibernate: insert into code (id) values (?)
2025-07-28T08:41:57.338+02:00  WARN 16792 --- [backend] [nio-8080-exec-5] o.h.engine.jdbc.spi.SqlExceptionHelper   : SQL Error: 1062, SQLState: 23000
2025-07-28T08:41:57.338+02:00 ERROR 16792 --- [backend] [nio-8080-exec-5] o.h.engine.jdbc.spi.SqlExceptionHelper   : Duplicate entry 'TEST' for key 'PRIMARY'

特殊情况 #

将CascadeType改为CascadeType.ALL时一切正常，但这种方式会在Code已存在时仍尝试保存Item，不符合我的需求。

我曾参考过相关技术论坛的帖子，但没能解决问题。

解决方案 #

1. 调整关联关系的主控方与级联方向 #

问题核心是当前的@MapsId配置加上级联方向导致Hibernate无法正确判断保存顺序。需要确保Code作为关联的主控方，调整级联触发方向：

• 修改Code实体的关联，添加级联操作：

@Entity
public class Code {
    
    @Id
    @Column(nullable = false, updatable = false, length = 20)
    private String id;
    
    @OneToOne(mappedBy = "code", fetch = FetchType.LAZY, cascade = CascadeType.PERSIST)
    private Item codeItem;
    
    // ... 省略其他字段和方法
}

• 同时移除Item实体中@OneToOne的cascade = {CascadeType.PERSIST}：

@Entity
public class Item {
    
    @Id
    @Column(name = "item_code")
    private String itemCode;
    
    @OneToOne(fetch = FetchType.LAZY, optional = false)
    @MapsId
    @JoinColumn(name = "item_code", nullable = false, unique = true)
    private Code code;
    
    @OneToOne(mappedBy = "item", fetch = FetchType.LAZY, cascade = CascadeType.PERSIST)
    private SingleItem singleItem;
    
    // ... 省略其他字段和方法
}

2. 手动控制保存顺序（更直观的方式） #

如果不想修改实体关联，可以在业务代码中手动判断Code是否存在，控制保存顺序：

@Service
public class ItemService {
    
    @Autowired
    private CodeRepository codeRepo;
    @Autowired
    private ItemRepository itemRepo;
    @Autowired
    private SingleItemRepository singleItemRepo;
    
    @Transactional
    public void saveSingleItemWithDependencies(SingleItem singleItem) {
        Item item = singleItem.getItem();
        Code code = item.getCode();
        
        // 先检查Code是否存在，不存在则保存
        if (codeRepo.findById(code.getId()).isEmpty()) {
            codeRepo.save(code);
        }
        // 保存Item（此时Code已存在，不会触发外键错误）
        itemRepo.save(item);
        // 保存SingleItem
        singleItemRepo.save(singleItem);
    }
}

3. 修正@MapsId的使用逻辑 #

你的@MapsId配置让Item的主键完全依赖Code的ID，但当前级联方向是从Item到Code，Hibernate会优先处理主控方（Item）。可以考虑将Item的主键改为独立生成，或者确保Code在Item之前被持久化。

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