Spring Boot+H2数据库引用完整性约束违反问题排查

核心问题原因 #

你遇到的外键约束违反，根源在于手动删除Book时未正确维护双向关联，导致数据库中仍存在关联的Book记录；或者是因为已经配置了完整的级联删除规则，手动删除的操作反而干扰了Hibernate的持久化逻辑，造成持久化上下文与数据库状态不一致。

解决方案 #

方案一：直接利用级联删除特性（推荐） #

你的Title实体已经配置了cascade = CascadeType.ALL和orphanRemoval = true，Book实体对Loan的关联也配置了相同的级联规则。这意味着删除Title时，Hibernate会自动级联删除所有关联的Book，以及每个Book关联的Loan，完全不需要手动处理关联对象。

修改测试代码如下：

@Test
@Transactional
void titleAssociationTest() {
    entityManager.remove(title);
    entityManager.flush();

    Title foundTitle = entityManager.find(Title.class, title.getId());
    assertThat(foundTitle).isNull();
}

方案二：手动删除时正确维护双向关联 #

如果一定要保留手动删除的逻辑，必须确保双向关联的两端都被正确更新（因为Book是双向关联的维护端，只有修改Book的title属性，Hibernate才会同步数据库外键）：

@Test
@Transactional
void titleAssociationTest() {
    // 使用Iterator遍历，避免循环中修改集合引发ConcurrentModificationException
    Iterator<Book> bookIterator = title.getBooks().iterator();
    while (bookIterator.hasNext()) {
        Book book = bookIterator.next();
        
        // 解除Book与Title的双向关联
        book.setTitle(null);
        bookIterator.remove();

        // 删除关联的Loan
        if (book.getLoan() != null) {
            entityManager.remove(book.getLoan());
        }
        // 删除Book
        entityManager.remove(book);
    }

    entityManager.flush();

    entityManager.remove(title);
    entityManager.flush();

    Title foundTitle = entityManager.find(Title.class, title.getId());
    assertThat(foundTitle).isNull();
}

关键说明 #

1. 双向关联的维护端：@ManyToOne注解所在的Book是双向关联的维护端，所有对关联关系的修改必须通过维护端完成（即修改book.setTitle(null)），否则Hibernate不会同步数据库的外键字段。
2. 级联规则的作用：配置CascadeType.ALL后，删除Title时会自动触发对关联Book的删除操作；orphanRemoval = true则会移除所有从Title的books集合中删除的Book实例，两者结合已经覆盖了你的手动删除需求。
3. 集合遍历注意事项：直接在forEach循环中调用集合的remove方法会抛出ConcurrentModificationException，使用Iterator遍历并移除元素是更安全的方式。

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