Spring MVC @RequestMapping 注解参数详解与实战

@RequestMapping 注解概述

@RequestMapping 是 Spring MVC 中用于处理请求地址映射的核心注解，既可用于类定义，也可作用于控制器方法。当应用于类级别时，该地址作为所有响应方法的父路径前缀；应用于方法级别时，则在类路径基础上进一步细分映射。

若类定义处未标注 @RequestMapping，则方法处的 URL 直接相对于 Web 应用的根目录。返回的视图名称会根据实际配置的映射路径自动拼接对应的 JSP/HTML 文件位置。例如，映射为 /default/index 时，通常对应项目中的 webapp/default/index.jsp。

第1步：基础 URL 映射与路径变量（value/path）

目的：设置基本的访问路径，支持动态参数绑定和正则表达式验证。

入口：Controller 类或方法上添加 @RequestMapping。

操作：

• 普通值：指定具体的静态 URI。
  @RequestMapping("/testRequestMapping")
• URI Template 模式：使用占位符实现 Restful 风格。若路径变量名与方法参数名一致，可直接使用 @PathVariable；若不一致，需显式指定绑定关系。
  

  @RequestMapping("/testPathVariable/{id}")
  public String testPathVariable(@PathVariable("id") Integer id2) {
      // ... 处理逻辑
      return "success";
  }

• 正则表达式验证：在路径变量后添加正则约束，确保参数格式符合预期。
  

  @RequestMapping("/spring-web/{symbolicName:[a-z-]+}-{version:\d\.\d\.\d}.{extension:\.[a-z]}")  
  public void handle(@PathVariable String version, @PathVariable String extension) {      
      // ...  
  }  
  

[path] 与 [value] 效果等同，可互换使用。

第2步：限制 HTTP 请求方法（method）

目的：严格限制接口仅接收特定类型的 HTTP 请求（如 GET, POST, PUT, DELETE），提高安全性。

操作：在注解中指定 method = RequestMethod.POST 等。

参数：RequestMethod 枚举值。

完成状态：若请求方法与指定不符，服务器将返回 HTTP 405 错误（Method Not Allowed）。例如，限制为 POST 而发起 GET 请求：
HTTP Status 405 - Request method 'GET' not supported。

若改为 method = RequestMethod.GET 且请求为 GET，则能正常跳转页面。

第3步：处理请求内容类型（consumes）

目的：指定控制器期望接收的请求体 Content-Type，通常用于 API 接口。

操作：设置 consumes="application/json"。

参数：有效的 MIME 类型字符串。

注意：如果默认表单提交（application/x-www-form-urlencoded）发送到设置了 consumes="application/json" 的接口，服务器无法识别媒介类型，将返回 HTTP 415 错误（Unsupported Media Type）。

移除 consumes 属性或使用 JSON 数据发送请求即可恢复正常。

第4步：指定响应内容类型（produces）

目的：声明返回值的内容类型，并检查客户端浏览器是否支持该类型（通过 Accept 请求头）。

操作：设置 produces="application/json"。

参数：MIME 类型。

原理：produces 不仅设定响应头，还会比对客户端发出的 Accept 头。例如浏览器通常携带 text/html,application/xhtml+xml,...,*/*;q=0.8，表示接受各种格式。如果服务器设定的 produce 类型完全不在客户端接受的列表中，请求将被拒绝。

@RequestMapping(value = "/testMethod", method = RequestMethod.POST,
produces="application/json")
public void testMethod2(HttpServletRequest request, HttpServletResponse response) throws IOException {
    // 手动输出 JSON 示例
    PrintWriter out = response.getWriter();
    out.print("{'name': 'helloworld'}");
}

第5步：精确匹配请求参数（params）

目的：根据请求中包含的参数键值对进行更细粒度的路由控制。

操作：params = { "username","age!=10" }

参数：参数名（必须存在）、paramName=value（必须等于某值）、paramName!=value（不等于某值）。

排错：如果请求缺少 username 或 age 等于 10，将触发 HTTP 400 错误（Bad Request），因为服务器未能理解预期的请求条件。

当 age 传参不为 10 时，条件满足，页面正常跳转。

第6步：拦截特定请求头（headers）

目的：基于 HTTP 头部信息进行过滤，常用于国际化或多版本 API 路由。

操作：headers = { "Accept-Language=zh-CN" }

参数：Header Name=Value 格式。

结果：只有当浏览器发送的 Accept-Language 包含 zh-CN 时才会命中此接口。若语言设置不匹配（如默认是 US），可能因路由未找到或其他校验失败导致 404 或 400 等状态码。

查看浏览器请求头：

后台代码如下：

@RequestMapping(value = "testParamsAndHeaders", headers = { "Accept-Language=US,zh;q=0.8" })

若语言不匹配：

调整为 zh-CN 后：

总结与常见状态码排查

在进行请求映射调试时，建议按以下逻辑顺序排查错误：

1. 第一步（URL 匹配）：首先检查 URL 是否能定位到对应的 HandlerMapping，找不到则返回 404。
2. 第二步（请求方法）：检查 HTTP Method（GET/POST 等），不匹配返回 405。
3. 第三步（Content-Type/Accept）：检查 consumes 和 produces，介质类型不支持返回 415 或不满足返回 406。
4. 第四步（参数与Header）：检查 Params 和 Headers，条件不符合通常返回 400。
5. 最后一步：若以上步骤均通过但内部逻辑出错，则可能产生 5XX 服务器错误。

以上就是 Spring MVC 中 @RequestMapping 的详细参数用法与实战排查指南，更多关于 Java 后端开发的资料请关注本站其它相关文章！