Spring Boot一对多关系下更新删除列表项出现JPA事务提交失败问题

错误根因 #

你遇到的事务回滚核心是双向关联的维护逻辑错误触发了数据库非空外键约束：

• 你在所有@OneToMany注解上用了mappedBy属性，说明关联关系的维护方是多端（也就是B类的a字段、C类的b字段这类），只有维护方字段的变化才会被JPA同步到数据库外键列
• B类的@ManyToOne设置了optional=false，要求a字段非空，你直接清空A的bs列表、或者直接删除B实例时，没有主动处理多端的关联字段，触发非空约束导致事务回滚

解决方案 #

方案1：手动处理关联关系后更新（无需改实体配置）

在事务内先解除旧数据的关联，再新增新的关联数据，示例代码如下：

@Transactional
public void updateBList(Long aId, List<B> newBList) {
    // 1. 查询要更新的A实例
    A targetA = aRepository.findById(aId).orElseThrow(() -> new RuntimeException("A实例不存在"));
    // 2. 遍历旧B列表，解除关联
    for (B oldB : targetA.getBs()) {
        // 主动清空维护方的关联字段，解除和A的绑定
        oldB.setA(null);
        // 若需要保留旧B数据到其他A实例，可在此处给oldB设置新的A实例，不需要保留则直接走级联删除
    }
    // 3. 清空旧集合
    targetA.getBs().clear();
    // 4. 给新B列表设置关联的A实例（必须操作，否则还是会触发非空约束）
    for (B newB : newBList) {
        newB.setA(targetA);
        targetA.getBs().add(newB);
    }
    // 5. 持久化A实例，级联生效
    aRepository.save(targetA);
}

方案2：开启orphanRemoval自动清理孤立项（推荐，简化代码）

先修改A类的@OneToMany配置，添加orphanRemoval = true：

@OneToMany(mappedBy = "a", cascade = CascadeType.ALL, orphanRemoval = true)
List<B> bs;

开启后JPA会自动删除和A解除关联的B实例（以及B级联关联的C、D实例），更新代码可以简化为：

@Transactional
public void updateBList(Long aId, List<B> newBList) {
    A targetA = aRepository.findById(aId).orElseThrow();
    targetA.getBs().clear();
    newBList.forEach(b -> b.setA(targetA));
    targetA.getBs().addAll(newBList);
    aRepository.save(targetA);
}

排查建议 #

如果修改后还是报错，可以在application.yml/application.properties中添加配置打印执行SQL，直接定位具体约束错误：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql=trace

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