
spring 通过动态代理与 threadlocal 结合,为单例控制器安全注入请求作用域 bean:每次方法调用时,代理从当前线程绑定的 httpservletrequest 中获取或创建专属实例,确保多并发请求间完全隔离。
spring 通过动态代理与 threadlocal 结合,为单例控制器安全注入请求作用域 bean:每次方法调用时,代理从当前线程绑定的 httpservletrequest 中获取或创建专属实例,确保多并发请求间完全隔离。
在 Spring 应用中,@RestController 等组件默认是单例(singleton)作用域,而 @RequestScope Bean(如自定义的 RequestContext)则需按 HTTP 请求生命周期独立创建。表面上看,将一个“每请求一实例”的 Bean 注入到“全局唯一”的控制器中似乎存在矛盾——但 Spring 通过作用域代理(Scoped Proxy)机制优雅地解决了这一问题。
核心原理:代理 + ThreadLocal + RequestAttributes
当声明 @RequestScope Bean 并被 @Autowired 到单例 Bean 中时,Spring 不会直接注入实际 Bean 实例,而是注入一个由 ScopedProxyFactoryBean 创建的 CGLIB 或 JDK 动态代理对象。该代理本身是单例的,但其所有方法调用均被拦截,并在运行时委托给当前请求对应的真正实例。
关键流程如下:
-
代理拦截调用:控制器中调用
requestContext.getData()时,实际触发的是代理对象的方法; -
定位当前请求上下文:代理通过
RequestScope.get(beanName, objectFactory)查找实例; -
基于 ThreadLocal 获取 RequestAttributes:Spring Web 在请求进入时(如
DispatcherServlet处理前)已将ServletRequestAttributes绑定到当前线程的ThreadLocal中; -
从 HttpServletRequest 属性中读取或创建 Bean:
ServletRequestAttributes内部将请求作用域 Bean 以键值对形式存储在HttpServletRequest.setAttribute()中(例如"scopedTarget.requestContext"),若不存在则通过ObjectFactory新建并缓存。
@Component
@RequestScope
public class RequestContext {
private final String requestId = UUID.randomUUID().toString();
public String getRequestId() {
return requestId;
}
}
@RestController
public class PersonController {
@Autowired
private RequestContext requestContext; // 注入的是代理,非真实实例
@GetMapping("/info")
public String getInfo() {
return "Request ID: " + requestContext.getRequestId(); // 每次调用都返回当前请求专属实例
}
}
并发场景下的安全性保障
面对 5 个并发 HTTP 请求:
- Servlet 容器(如 Tomcat)为每个请求分配独立线程;
- 每个线程拥有自己的
ThreadLocal,其中封装了唯一的HttpServletRequest; - 各线程调用同一控制器实例的同一方法时,代理分别从各自
ThreadLocal中取出对应RequestContext实例; - 因此:5 个请求 → 5 个线程 → 5 个独立
RequestContext实例 → 彼此完全隔离,无状态竞争。
✅ 注意事项:
- 必须启用作用域代理:使用
@RequestScope(proxyMode = ScopedProxyMode.TARGET_CLASS)(推荐 CGLIB 代理,支持任意类型)或在配置类中显式声明@Bean+@Scope(proxyMode = ...);- 不要在非 Web 环境(如单元测试、定时任务)中直接依赖
@RequestScopeBean,否则会抛出IllegalStateException: No thread-bound request found;- 避免在
@RequestScopeBean 中持有跨请求的可变状态(虽天然隔离,但语义上违背设计初衷)。
总之,Spring 的请求作用域并非“注入一个实例”,而是“注入一个智能代理”,它像一位精准的调度员,在每次方法调用时实时匹配当前线程所属的 HTTP 请求上下文,从而实现单例容器与请求级状态的无缝协同。









