Spring Controller如何支持同一接口POST接收List或Map类型JSON？

嘿，这个问题我之前也帮不少开发者解决过——Spring MVC在遇到相同路径和HTTP方法的接口时，确实没法仅凭参数类型来区分请求，直接新增参数不同的方法肯定会报映射歧义。给你几个实用的解决方案，按需选就行：

方案一：通过请求参数区分 #

在请求里加一个标识参数（比如dataType），Spring会根据这个参数的存在或值来匹配对应的方法，完美避开冲突：

@RestController
public class PersonController {
    // 处理Map请求，默认匹配（如果不传dataType）
    @PostMapping("/generic")
    public void handleMap(@RequestParam(value = "dataType", defaultValue = "map") String dataType,
                          @RequestBody Map<String, String> params) {
        // 处理普通Map逻辑
        System.out.println("Received Map: " + params);
    }

    // 仅当dataType=list时匹配，处理List请求
    @PostMapping("/generic")
    public void handleList(@RequestParam("dataType") String dataType,
                          @RequestBody List<Person> personList) {
        // 处理对象列表逻辑
        System.out.println("Received List: " + personList);
    }
}

使用说明：客户端发送Map请求时可以不传dataType，或者传dataType=map；发送List请求时必须传dataType=list。

方案二：通过请求头区分 #

利用请求头（比如自定义头X-Data-Type或标准的Content-Type）来区分请求类型，这种方式更符合REST风格，不会污染URL：

方式A：自定义Content-Type #

让客户端发送请求时指定不同的Content-Type，Spring通过consumes属性匹配：

import org.springframework.http.MediaType;

@RestController
public class PersonController {
    // 处理普通JSON Map，匹配默认的application/json
    @PostMapping(value = "/generic", consumes = MediaType.APPLICATION_JSON_VALUE)
    public void handleMap(@RequestBody Map<String, String> params) {
        // 处理Map逻辑
    }

    // 处理列表，匹配自定义的Content-Type
    @PostMapping(value = "/generic", consumes = "application/json+list")
    public void handleList(@RequestBody List<Person> personList) {
        // 处理List逻辑
    }
}

使用说明：客户端发送List请求时，需要设置请求头Content-Type: application/json+list，发送Map请求用默认的application/json即可。

方式B：在同一方法内通过请求头判断 #

如果不想拆分方法，可以在一个接口里接收通用的Object类型，再通过请求头判断并转换：

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;
import java.util.Map;

@RestController
public class PersonController {
    private final ObjectMapper objectMapper;

    // 注入ObjectMapper
    public PersonController(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @PostMapping("/generic")
    public void handleRequest(@RequestHeader(value = "X-Data-Type", required = false) String dataType,
                              @RequestBody Object payload) throws Exception {
        if ("list".equals(dataType)) {
            // 转换为Person列表
            List<Person> personList = objectMapper.convertValue(payload, new TypeReference<List<Person>>() {});
            // 处理List逻辑
        } else {
            // 转换为Map
            Map<String, String> params = objectMapper.convertValue(payload, new TypeReference<Map<String, String>>() {});
            // 处理Map逻辑
        }
    }
}

使用说明：客户端发送List请求时设置请求头X-Data-Type: list，其余情况默认处理Map。

方案三：使用自定义参数解析器（进阶） #

如果需要更通用的类型判断逻辑，可以自定义Spring的参数解析器，自动识别请求体是Map还是List并转换。不过这个方案相对复杂，适合多个接口都有类似需求的场景，前面的方案已经能覆盖大部分情况了，这里就不展开细讲啦。

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