SpringBoot中用RestTemplate上传多文件及信息的微服务问题

1. 当前实现的问题点 #

你的代码存在多处错误，并非正确实现：

• A服务RestTemplate调用逻辑错误：直接将List<ARequest>放入HttpEntity并设置multipart/form-data是无效的，Spring的RestTemplate默认没有能处理这种方式的消息转换器，这也是你第三个问题报错的核心原因。Multipart请求需要将每个字段和文件拆分为独立的part，而非直接传递对象列表。
• AService语法与逻辑缺失：responseEResponsentity的泛型类型错误（应是ResponseEntity<List<Response>>而非ResponseEntity<List<A>>），且方法末尾未返回该对象。
• BService代码不完整：return Response;只是占位符，未实际构建并返回ResponseEntity<List<Response>>；调用C服务的逻辑也未实现，需确保传递MultipartFile时符合C服务的接口要求。
• 控制器列表参数绑定问题：Spring通过@ModelAttribute接收列表时，前端请求参数必须按files[0].tag、files[0].fileContent这种带索引的格式传递，否则无法正确绑定到List<ARequest>。

2. Postman测试步骤 #

测试A服务的上传接口，按以下操作：

1. 新建POST请求，填写A服务的/document/upload地址。
2. 切换到Body标签，选择form-data格式。
3. 添加请求参数：
   • 第一个参数：Key填clientId，Type选Text，Value输入测试用整数（如123）。
   • 按索引添加每个文件的对应字段：
     • 第一个文件的标签：Key填files[0].tag，Type选Text，输入标签内容。
     • 第一个文件的显示名：Key填files[0].displayName，Type选Text，输入名称。
     • 第一个文件：Key填files[0].fileContent，Type选File，点击右侧选择本地文件。
     • 第二个文件同理：依次添加files[1].tag、files[1].fileContent等，按需添加多个文件项。
4. 直接点击发送，Postman会自动设置正确的multipart/form-data请求头。

3. 错误原因及修复方案 #

（1）No HttpMessageConverter for java.util.ArrayList and content type "multipart/form-data"错误 #

原因：你试图直接将List<ARequest>作为请求体发送，但RestTemplate无法将列表直接序列化为multipart格式。修复方法是手动构建MultiValueMap组装multipart请求的各个part：
修改A服务的AService.java代码：

public ResponseEntity<List<Response>> uploadDocuments(Integer clientId, List<ARequest> aRequestList) throws IOException {
    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.MULTIPART_FORM_DATA);

    MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
    body.add("clientId", clientId); // 传递clientId参数

    // 逐个处理ARequest，拆分为对应的请求part
    for (int i = 0; i < aRequestList.size(); i++) {
        ARequest req = aRequestList.get(i);
        body.add("files[" + i + "].tag", req.getTag());
        body.add("files[" + i + "].displayName", req.getDisplayName());
        body.add("files[" + i + "].description", req.getDescription());
        // 将MultipartFile转换为Resource，RestTemplate会自动处理为file类型的part
        body.add("files[" + i + "].fileContent", new ByteArrayResource(req.getFileContent().getBytes()) {
            @Override
            public String getFilename() {
                return req.getFileContent().getOriginalFilename();
            }
        });
    }

    HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(body, headers);
    // 修正泛型类型，直接指定List<Response>
    ResponseEntity<List<Response>> response = restTemplate.exchange(
            "SomeUrl", 
            HttpMethod.POST, 
            requestEntity, 
            new ParameterizedTypeReference<List<Response>>() {}
    );
    return response;
}

（2）400 Bad Request错误 #

常见原因及解决：

• 请求参数格式错误：确保Postman中参数命名为files[0].xxx这种带索引的格式，与控制器的@ModelAttribute("files") List<ARequest>对应。
• 参数类型不匹配：确保BRequest与ARequest的字段名、数据类型完全一致，否则参数绑定失败会返回400。
• 缺少必填参数：检查clientId是否正确传递，上述修复代码已添加该参数的传递逻辑。

另外，B服务调用C服务时，需参照上述方式用RestTemplate构建multipart请求，确保正确传递MultipartFile。

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