@RequestAttribute用于从HttpServletRequest的attribute中读取已存在的值,不负责设置;适用于Filter、Interceptor等跨组件共享数据场景,需属性名完全匹配,支持required=false和@DefaultValue设默认值。

@RequestAttribute 是 Spring MVC 提供的注解,用于将 请求域(HttpServletRequest 的 attribute) 中已存在的值注入到控制器方法参数中。它不负责设置属性,只负责读取——即该属性必须由其他组件(如 Filter、Interceptor、另一个 Controller、或 request.setAttribute())提前存入当前请求对象中。
什么时候需要用 @RequestAttribute?
常见于需要在请求处理链路中跨组件共享数据的场景,例如:
- Filter 中鉴权后把用户信息存入 request.setAttribute("currentUser", user)
- HandlerInterceptor 的 preHandle 方法中设置上下文信息
- 多个 Controller 共享前置处理器准备好的数据,避免重复查询
基本用法:绑定请求属性值
假设在某个 Filter 中执行了:
request.setAttribute("traceId", "abc123");
那么在 Controller 方法中可直接获取:
@GetMapping("/api/data")
public String handle(@RequestAttribute("traceId") String traceId) {
System.out.println(traceId); // 输出 abc123
return "success";
}
注意:属性名必须与 request.setAttribute(key, value) 中的 key 完全一致,区分大小写。
立即学习“Java免费学习笔记(深入)”;
可选属性与默认值处理
如果属性可能不存在,又不想抛出异常,可以设 required = false,并配合 @DefaultValue 指定默认值:
@GetMapping("/api/log")
public String log(@RequestAttribute(value = "userId", required = false)
@DefaultValue("anonymous") String userId) {
// 若 request 中无 "userId",则 userId = "anonymous"
return "logged by " + userId;
}
此时若未设置该属性,不会报错,也不会注入 null(除非显式允许 null)。
与 @RequestParam、@ModelAttribute 的区别
别混淆这几个注解的作用范围:
- @RequestParam:从 URL 查询参数(?key=value)或表单字段中取值
- @ModelAttribute:从请求参数绑定到对象,或从 Model 中取已有对象
- @RequestAttribute:仅从 HttpServletRequest 的 attribute Map 中取值(内存级、一次请求内有效)
它们来源不同,不能互相替代。比如 request.setAttribute("user", u) 后,只能用 @RequestAttribute("user") 获取,不能用 @RequestParam("user")。


















