Spring中能否用@RequestMapping定义同路径但headers不同的方法？

是否允许路径、请求方法相同但headers不同的映射？ #

Spring 支持通过headers属性区分相同路径和请求方法的控制器方法，只要headers条件存在差异，就能被识别为不同的映射规则。但你遇到的报错并非源于headers本身，而是GET请求与@RequestBody搭配导致的映射冲突。

报错核心原因 #

你的两个方法同时声明支持GET和POST请求：

• 对于POST请求，headers = JSON可以有效区分两个方法；
• 但GET请求本身没有请求体，Spring会自动将@RequestBody参数解析为URL请求参数，这就导致两个方法的GET映射规则完全一致（路径、请求方法相同，且GET场景下headers的区分逻辑失效），最终触发"Ambiguous mapping"错误。

解决方法 #

方案1：拆分GET/POST请求，移除GET的@RequestBody #

将GET和POST请求分开处理，GET方法改用请求参数接收数据（需确保SearchFiltersWithTypeRequest支持Spring的请求参数绑定）：

// 处理POST请求，仅匹配带JSON请求头的请求
@RequestMapping(value = SEARCH_BY_FILTERS_WITH_TYPE, method = RequestMethod.POST, headers = JSON)
@Secured(Permissions.VIEW)
@ResponseBody
public AjaxJsonResponseBuilder searchForFiltersWithTypeJson(@RequestBody SearchFiltersWithTypeRequest request) {
    return search(request);
}

// 处理GET请求，通过URL参数接收数据
@RequestMapping(value = SEARCH_BY_FILTERS_WITH_TYPE, method = RequestMethod.GET)
@Secured(Permissions.VIEW)
@ResponseBody
public AjaxJsonResponseBuilder searchForFiltersWithType(SearchFiltersWithTypeRequest request) {
    return search(request);
}

方案2：合并方法，内部根据请求头判断逻辑 #

保留一个统一的映射方法，在方法内部根据请求头和请求类型处理不同逻辑，避免映射冲突：

@RequestMapping(value = SEARCH_BY_FILTERS_WITH_TYPE, method = {RequestMethod.GET, RequestMethod.POST})
@Secured(Permissions.VIEW)
@ResponseBody
public AjaxJsonResponseBuilder searchForFiltersWithType(
        @RequestBody(required = false) SearchFiltersWithTypeRequest request,
        @RequestHeader(value = "Content-Type", required = false) String contentType) {
    // 处理带JSON请求头的POST请求
    if (JSON.equals(contentType) && request != null) {
        return search(request);
    }
    // 处理GET请求或非JSON头的POST请求（可从请求参数构建request对象）
    SearchFiltersWithTypeRequest paramRequest = buildRequestFromRequestParams();
    return search(paramRequest);
}

// 辅助方法：从请求参数构建请求对象
private SearchFiltersWithTypeRequest buildRequestFromRequestParams() {
    // 实现参数绑定逻辑
}

方案3：限定带headers的方法为POST专属 #

如果headers = JSON仅针对POST请求，直接将第一个方法的请求方法限定为POST，这样GET请求只会匹配第二个方法，不会产生冲突：

@RequestMapping(value = SEARCH_BY_FILTERS_WITH_TYPE, method = RequestMethod.POST, headers = JSON)
@Secured(Permissions.VIEW)
@ResponseBody
public AjaxJsonResponseBuilder searchForFiltersWithTypeJson(@RequestBody SearchFiltersWithTypeRequest request) {
    return search(request);
}

@RequestMapping(value = SEARCH_BY_FILTERS_WITH_TYPE, method = {RequestMethod.GET, RequestMethod.POST})
@Secured(Permissions.VIEW)
@ResponseBody
public AjaxJsonResponseBuilder searchForFiltersWithType(SearchFiltersWithTypeRequest request) {
    return search(request);
}

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