Spring Boot POST控制器接收多类型HashMap的Postman测试方法

首先要明确：用@RequestBody接收HashMap<String, Object>的写法无法同时处理文件和JSON参数，因为@RequestBody仅能解析单一格式的请求体（比如纯JSON），而包含文件的请求属于multipart/form-data类型，是多部分结构。下面是修正后的控制器实现和Postman测试步骤：

一、修正控制器代码 #

我们需要通过multipart/form-data请求分别接收文件和JSON格式的元数据，再组装成目标HashMap：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.HashMap;
import java.util.Map;

@RestController
public class MixedRequestController {

    private final ObjectMapper objectMapper;

    // 注入Spring自动配置的ObjectMapper，用于JSON解析
    public MixedRequestController(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @PostMapping("/process-mixed-data")
    public Map<String, Object> handleMixedRequest(
            @RequestParam("myFile") MultipartFile myFile,
            @RequestParam("metadata") String metadataJson) throws Exception {
        // 将JSON字符串解析为你的POJO类（替换成实际的POJO类型）
        YourMetadataPojo metadata = objectMapper.readValue(metadataJson, YourMetadataPojo.class);
        
        // 组装成要求的HashMap
        HashMap<String, Object> requestMap = new HashMap<>();
        requestMap.put("myFile", myFile);
        requestMap.put("metadata", metadata);
        
        // 这里添加你的业务逻辑处理
        return requestMap;
    }

    // 示例POJO，替换成你实际的元数据类
    static class YourMetadataPojo {
        private String fileName;
        private String fileType;
        private long sizeLimit;
        
        // 必须提供无参构造器，以及对应的getter/setter
        public YourMetadataPojo() {}
        
        // getter和setter省略
    }
}

二、Postman测试步骤 #

按照以下配置发送请求：

1. 创建POST请求，填入接口地址（比如http://localhost:8080/process-mixed-data）
2. 切换到Body标签，选择form-data选项
3. 添加两个请求参数：
   • 参数名：myFile，类型选择File，点击右侧的「Select Files」选择本地物理文件
   • 参数名：metadata，类型选择Text，在值输入框中填入你的元数据JSON字符串，示例：

     {
         "fileName": "测试文档",
         "fileType": "PDF",
         "sizeLimit": 10485760
     }
     

4. 点击「Send」发送请求，即可看到控制器返回的处理结果

三、关键注意事项 #

• Spring Boot默认开启Multipart文件上传支持，无需额外配置，若需调整文件大小限制，可在application.properties中添加配置（比如spring.servlet.multipart.max-file-size=10MB）
• 确保元数据JSON格式严格匹配你的POJO字段名，否则会出现解析失败
• 如果需要支持多文件上传，可将@RequestParam("myFile")改为@RequestParam("myFile") List<MultipartFile>，同时在Postman中添加多个同名的myFile参数

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