迁移至Hibernate 6与Spring Boot 3后，实体插入顺序异常引发外键约束错误

看起来你遇到了Hibernate 6（伴随Spring Boot 3升级）里实体插入顺序变化的坑，这种外键约束错误确实挺头疼的，我来帮你分析下原因和解决办法。

问题根源分析 #

Hibernate 6在实体持久化逻辑上做了不少优化调整，尤其是对关联实体的依赖识别变得更严格。结合你的代码来看，主要有两个关键点：

1. 双向关联未完整维护：你在Test1里定义了@OneToMany的contacts集合，但测试代码中只创建了Test1和Test2，却没有把Test2添加到Test1的集合中。Hibernate的持久化上下文依赖内存中的双向关联关系来判断实体的依赖顺序，缺少这一步会让它无法识别Test1是Test2的父实体。
2. EmbeddedId关联配置模糊：Test2使用了@EmbeddedId，同时单独维护了object字段和test1Id的关联，且test1Id的@JoinColumn设置了updatable = false, insertable = false，这可能让Hibernate无法正确识别该关联对应的外键依赖关系，进而打乱了插入顺序。

解决方案 #

1. 完整维护双向关联（优先推荐）

JPA规范中，双向关联需要在内存中同时维护双方的关系，这样Hibernate才能正确感知依赖顺序。修改你的测试代码：

@Autowired private EntityManager db;

Test1 test1 = createDefTest1();
Test2 test2 = createDefTest2(test1);

// 维护双向关联，这一步至关重要
test1.getContacts().add(test2);
test2.setTest1Id(test1); // 虽然数据库字段不允许插入/更新，但内存关联必须到位

db.persist(test1);
db.persist(test2);
// some code
Object t = someJpa.findById(someid);

添加这两步后，Hibernate就能明确Test1是Test2的依赖实体，会优先插入Test1。

2. 优化EmbeddedId的关联配置

针对Test2的@EmbeddedId场景，你可以用@MapsId注解明确关联关系，让Hibernate识别外键对应的嵌入式ID字段。假设你的ImpactKey类中有对应object_id的字段（比如objectId），修改Test2的关联注解：

@ManyToOne(fetch = FetchType.LAZY)
@EqualsAndHashCode.Exclude
@ToString.Exclude
@JoinColumn(name = "object_id", referencedColumnName = "guid", updatable = false, insertable = false)
@MapsId("objectId") // 对应ImpactKey中的objectId字段
private Test1 test1Id;

这样Hibernate能更清晰地理解Test2依赖Test1的外键关系，自动调整插入顺序。

3. 手动强制持久化顺序（兜底方案）

如果上述方法暂时无法生效，可以手动调用flush()强制将Test1写入数据库，确保Test2插入时外键已存在：

db.persist(test1);
db.flush(); // 强制Test1的记录写入数据库
db.persist(test2);

总结 #

Hibernate 6对关联关系的校验和依赖识别更严格，核心解决思路是确保内存中的双向关联完整，这也是JPA开发的最佳实践。优先尝试第一种方案，既能解决插入顺序问题，也能保证实体关联的规范性。

备注：内容来源于stack exchange，提问作者Mike Sonarov