SpringBoot中如何基于不同@RequestBody类型重载控制器API？

你遇到的Ambiguous mapping错误，是因为Spring MVC在匹配请求映射时，不会根据@RequestBody的参数类型来区分接口。两个接口的请求方法（POST）、路径（/register）完全一致，Spring无法判断应该把请求转发给哪个方法，因此启动时抛出映射歧义异常。

以下是几种可行的解决方案：

方案一：使用不同的请求路径（推荐） #

遵循REST风格设计原则，给批量注册接口单独设置子路径，比如/register/batch，通过路径区分两个接口，避免冲突：

@RequestMapping(method = RequestMethod.POST, value = "/register")
public Status registerConnection(@RequestBody Connection connection) throws Exception 
{
    // 单个连接注册逻辑
}

@RequestMapping(method = RequestMethod.POST, value = "/register/batch")
public Status registerConnections(@RequestBody List<Connection> connections){ 
    // 批量连接注册逻辑
}

这种方式语义清晰，符合接口设计最佳实践，后续维护更直观。

方案二：在同一个接口中兼容两种请求体类型 #

将两个接口合并为一个，通过解析请求体类型分别处理单个对象和集合，有两种实现方式：

方式1：用Object接收并判断类型 #

@RequestMapping(method = RequestMethod.POST, value = "/register")
public Status register(@RequestBody Object requestBody) throws Exception 
{
    if (requestBody instanceof Connection) {
        return handleSingleConnection((Connection) requestBody);
    } else if (requestBody instanceof List) {
        List<?> list = (List<?>) requestBody;
        if (!list.isEmpty() && list.get(0) instanceof Connection) {
            return handleBatchConnections((List<Connection>) list);
        }
    }
    // 参数格式错误时返回对应状态
    return Status.INVALID_PARAM;
}

// 提取原逻辑为私有方法
private Status handleSingleConnection(Connection connection) {
    // 原单个注册逻辑
}

private Status handleBatchConnections(List<Connection> connections) {
    // 原批量注册逻辑
}

方式2：自行解析请求体（更可靠） #

如果担心Jackson自动类型转换的问题，可以用String接收请求体，再通过ObjectMapper手动解析：

@RequestMapping(method = RequestMethod.POST, value = "/register")
public Status register(@RequestBody String requestBody, ObjectMapper objectMapper) throws Exception 
{
    try {
        // 先尝试解析为单个Connection
        Connection connection = objectMapper.readValue(requestBody, Connection.class);
        return handleSingleConnection(connection);
    } catch (JsonMappingException e) {
        // 单个解析失败，尝试解析为集合
        try {
            List<Connection> connections = objectMapper.readValue(
                requestBody, 
                new TypeReference<List<Connection>>() {}
            );
            return handleBatchConnections(connections);
        } catch (JsonProcessingException ex) {
            // 两种格式都不匹配，返回参数错误
            return Status.INVALID_PARAM;
        }
    }
}

方案三：通过请求参数区分映射 #

利用@RequestMapping的params属性，指定不同的请求参数来区分两个接口。比如添加type参数，单个请求传type=single，批量传type=batch：

@RequestMapping(method = RequestMethod.POST, value = "/register", params = "type=single")
public Status registerConnection(@RequestBody Connection connection) throws Exception 
{
    // 单个注册逻辑
}

@RequestMapping(method = RequestMethod.POST, value = "/register", params = "type=batch")
public Status registerConnections(@RequestBody List<Connection> connections){ 
    // 批量注册逻辑
}

这种方式无需修改路径，但调用接口时必须携带指定参数，适合不想改动路径的场景。

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