Node-RED向Spring Boot控制器传附件时MultipartFile为空求助

核心问题分析 #

你遇到的问题本质是 Node-RED 构造的 multipart/form-data 请求格式不符合 Spring Boot 接收要求，导致接口无法正确解析文件参数。以下是针对性的排查步骤和解决方案：

一、先验证 Spring Boot 接口本身是否正常 #

用 Postman 或 curl 直接模拟请求，确认接口能正常接收文件：

1. 选择 POST 请求，设置 Content-Type: multipart/form-data
2. 添加多个文件参数，参数名设为 attachments（和控制器注解一致）
3. 发送请求，查看控制台是否能打印文件信息。如果这里正常，说明问题出在 Node-RED 的请求构造上。

二、Node-RED 侧正确构造 multipart 请求 #

无论使用内置 HTTP 节点还是 http-send-multipart-formdata 节点，都需要确保 payload 格式完全符合要求：

1. 正确的文件数组结构
   每个文件对象必须包含三个核心字段：

   • name: 必须和 Spring Boot 控制器的 @RequestParam 参数名一致（比如 attachments）
   • filename: 文件名
   • data: 文件内容（必须是 Buffer 类型，如果是 base64 编码需转换）

   示例函数节点代码：

   // 假设邮件附件存储在 msg.payload.attachments 中
   msg.payload = msg.payload.attachments.map(att => {
       // 若附件内容是 base64 格式，需转成 Buffer
       const fileData = typeof att.content === 'string' ? Buffer.from(att.content, 'base64') : att.content;
       return {
           name: "attachments", // 与控制器参数名严格一致
           filename: att.filename,
           data: fileData
       };
   });
   // 手动设置请求头（部分节点会自动处理，加上更保险）
   msg.headers = {
       "Content-Type": "multipart/form-data"
   };
   return msg;
   

2. 使用 http-send-multipart-formdata 节点的注意事项

   • 确保节点配置中没有强制覆盖表单字段名
   • Debug 节点查看发送前的 payload，确认每个文件的 name 确实是 attachments，而非其他值

三、Spring Boot 控制器优化 #

调整控制器注解，明确指定请求类型，避免潜在的解析问题：

import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;

@PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<String> post(@RequestParam("attachments") MultipartFile[] attachments) {
    if (attachments != null && attachments.length > 0) {
        System.out.println("成功接收 " + attachments.length + " 个文件");
        for (MultipartFile file : attachments) {
            System.out.println("文件名：" + file.getOriginalFilename());
        }
    } else {
        System.out.println("未接收到文件");
    }
    return ResponseEntity.ok("OK!!!");
}

四、常见坑点排查 #

1. 文件数据类型错误：如果 Node-RED 中的附件内容是字符串或 base64，未转成 Buffer，Spring Boot 无法解析
2. 参数名不匹配：Node-RED 中文件的 name 和控制器 @RequestParam 的值必须完全一致（大小写敏感）
3. 请求头缺失：未正确设置 Content-Type: multipart/form-data，导致 Spring Boot 无法识别请求类型

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