如何用Postman测试含MultiPartFile与额外数据的文件上传API

首先要说明：你当前的API代码存在问题——@RequestBody注解仅能处理JSON/XML这类单一格式的请求体，而包含文件的multipart/form-data请求需要调整接收方式，以下是修正后的两种API写法：

修正后的API代码示例 #

方式一：分开接收参数

@PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
String uploadFile(
    @RequestPart("file") MultipartFile file,
    @RequestPart("data") Data data
) {
    return service.uploadFile(file, data);
}

方式二：用UploadFileRequest类接收

@PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
String uploadFile(@ModelAttribute UploadFileRequest input) {
    return service.uploadFile(input.getFile(), input.getData());
}

Postman发送请求的具体步骤 #

1. 配置请求基础信息

   • 选择POST请求方法，输入你的API接口完整URL。

2. 设置请求体格式

   • 切换到Body标签页，选中form-data选项（不要选raw或x-www-form-urlencoded）。

3. 添加文件参数

   • 点击Add按钮新增参数：
     • Key栏填写file（需与API中定义的参数名完全一致）
     • 将右侧的类型从Text切换为File
     • 点击Select Files按钮，选择本地待上传的文件。

4. 添加额外JSON数据

   • 再次点击Add按钮新增参数：
     • Key栏填写data（需与API中定义的参数名完全一致）
     • 类型保持Text不变
     • Value栏输入符合Data类结构的JSON数据，例如：

       {
         "name": "测试文件",
         "type": "image",
         "sizeLimit": 1024000
       }
       

5. 发送请求

   • 确认所有参数配置无误后，点击Send按钮即可完成请求发送。

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