Spring Data REST发送空数组PATCH请求时抛出集合级联异常的排查

问题回顾 #

你遇到的异常 A collection with cascade="all-delete-orphan" was no longer referenced by the owning entity instance，本质上和你重写equals/hashCode的操作无关——这个错误的核心是Spring Data REST处理PATCH请求时的集合策略，和Hibernate对orphanRemoval=true集合的引用一致性要求冲突。

当你发送{"islands":[]}的PATCH请求时，Spring Data REST默认会直接把Atoll中的islands字段替换成一个新的空ArrayList实例。但Hibernate对于标记了orphanRemoval=true的集合，要求必须始终持有对原有集合实例的引用——因为它需要追踪原有集合中的元素变化来执行"删除孤儿"的逻辑，一旦集合引用被替换，Hibernate就无法追踪原有元素，从而抛出异常。

修复方案 #

方案1：修改Spring Data REST的集合合并策略（推荐）

通过配置RepositoryRestConfigurer，将Atoll实体的PATCH请求集合处理策略从默认的REPLACE改为MERGE。这样Spring Data REST会清空原有集合的元素，而不是替换整个集合引用：

import org.springframework.context.annotation.Configuration;
import org.springframework.data.rest.core.config.RepositoryRestConfiguration;
import org.springframework.data.rest.webmvc.config.RepositoryRestConfigurer;

@Configuration
public class RestConfig implements RepositoryRestConfigurer {
    @Override
    public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config) {
        // 为Atoll实体开启PATCH请求的集合MERGE策略
        config.setCollectionResourceMappingForDomainType(Atoll.class)
              .setMergeStrategyOnPatch(true);
    }
}

方案2：自定义Controller处理PATCH请求

如果不想修改全局策略，可以编写一个自定义Controller，手动处理集合更新逻辑，确保只清空原有集合而非替换引用：

import org.springframework.web.bind.annotation.PatchMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class AtollController {
    private final AtollRepository atollRepository;

    // 构造注入Repository
    public AtollController(AtollRepository atollRepository) {
        this.atollRepository = atollRepository;
    }

    @PatchMapping("/atolls/{id}")
    public Atoll patchAtoll(@PathVariable Long id, @RequestBody Atoll patchRequest) {
        return atollRepository.findById(id).map(existingAtoll -> {
            // 更新基本属性
            existingAtoll.setAtollName(patchRequest.getAtollName());
            
            // 处理空集合请求：清空原有集合，而非替换引用
            if (patchRequest.getIslands() != null && patchRequest.getIslands().isEmpty()) {
                existingAtoll.getIslands().clear();
            }
            
            return atollRepository.save(existingAtoll);
        }).orElseThrow(() -> new RuntimeException("Atoll with id " + id + " not found"));
    }
}

方案3：优化实体的集合setter方法

修改Atoll类的setIslands方法，确保永远不替换集合引用，只修改原有集合的内容：

// 在Atoll类中替换默认的setIslands方法
public void setIslands(List<Island> islands) {
    // 清空原有集合
    this.islands.clear();
    // 添加新元素（如果有）
    if (islands != null) {
        this.islands.addAll(islands);
    }
}

这样即使Spring Data REST调用setter，也不会改变集合引用，Hibernate就能正常追踪元素变化并执行删除操作。

总结 #

这个问题的关键是避免替换Atoll.islands的集合引用，只要保证Hibernate始终能访问到最初的集合实例，orphanRemoval=true的逻辑就能正常工作。推荐优先使用方案1，它最贴合Spring Data REST的设计理念，无需额外编写Controller或修改实体逻辑。

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