Spring Boot一对多关联场景下REST PUT操作失败求助

你遇到的这个问题是Spring Data REST处理多态关联集合时的已知bug（对应DATAREST-1012），核心原因是PUT请求的全量替换逻辑会尝试将现有持久化实体（比如原有的Header实例）直接替换为请求体里的其他类型实例（比如Footer），而JPA不允许修改实体的类型，因此抛出Target bean of type ... is not of type of the persistent entity异常。

下面给你几个可行的解决办法：

1. 使用PATCH请求替代PUT #

PUT是全量替换资源，而PATCH是部分更新，Spring Data REST处理PATCH时不会直接替换整个modules集合，而是会根据请求内容对现有集合进行增量修改，从而避免类型不匹配问题。

比如你可以发送如下PATCH请求来更新某个Module的内容：

{
  "modules": [
    { "id": 1, "content": "Updated header" },
    { "id": 2, "content": "Updated article" }
  ]
}

如果需要添加新的Module，直接在数组里加入新的对象即可；如果需要删除某个Module，可以通过_links里的删除链接单独操作，或者使用PATCH结合$remove指令（取决于Spring Data REST版本）。

2. 自定义实体合并逻辑 #

如果必须使用PUT请求，可以通过自定义Spring Data REST的事件监听器来手动处理集合的合并逻辑，确保不会替换实体类型：

步骤1：实现BeforeSaveEventListener #

@Component
public class ProjectBeforeSaveListener implements BeforeSaveEventListener<Project> {

    @Override
    public void onBeforeSave(BeforeSaveEvent<Project> event) {
        Project existingProject = event.getSource();
        Project incomingProject = (Project) event.getEntity();

        // 遍历传入的modules，匹配现有集合中的实体，只更新属性不替换实例
        Map<Long, Module> existingModules = existingProject.getModules().stream()
                .collect(Collectors.toMap(Module::getId, Function.identity()));

        List<Module> updatedModules = new ArrayList<>();
        for (Module incomingModule : incomingProject.getModules()) {
            if (incomingModule.getId() != null && existingModules.containsKey(incomingModule.getId())) {
                // 找到现有实体，更新属性
                Module existingModule = existingModules.get(incomingModule.getId());
                existingModule.setContent(incomingModule.getContent());
                updatedModules.add(existingModule);
            } else {
                // 新实体直接添加
                incomingModule.setProject(existingProject);
                updatedModules.add(incomingModule);
            }
        }

        // 替换现有集合，处理孤儿删除
        existingProject.getModules().clear();
        existingProject.getModules().addAll(updatedModules);
    }
}

步骤2：调整默认合并行为 #

配置Spring Data REST，让它优先使用你的自定义监听器逻辑，或者通过@RepositoryRestResource的参数调整默认的合并策略，避免直接替换集合内的实体实例。

3. 升级Spring Data REST版本 #

这个bug在Spring Data REST 3.0.0.RELEASE（对应Spring Boot 2.0.0.RELEASE及以上版本）中已经被修复。如果你的项目允许升级依赖，直接升级到较新的版本是最彻底的解决方案，不需要额外编写代码。

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