Spring 中请求作用域 Bean 的注入机制详解

酷萱姑娘_9740

酷萱姑娘_9740

2026-11-20

859人浏览

原创

Spring 中请求作用域 Bean 的注入机制详解

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 动态代理对象。该代理本身是单例的,但其所有方法调用均被拦截,并在运行时委托给当前请求对应的真正实例。

关键流程如下:

  1. 代理拦截调用:控制器中调用 requestContext.getData() 时,实际触发的是代理对象的方法;
  2. 定位当前请求上下文:代理通过 RequestScope.get(beanName, objectFactory) 查找实例;
  3. 基于 ThreadLocal 获取 RequestAttributes:Spring Web 在请求进入时(如 DispatcherServlet 处理前)已将 ServletRequestAttributes 绑定到当前线程的 ThreadLocal 中;
  4. 从 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 请求:

Gemini
Gemini

Gemini是一款由 Google 提供的个人 AI 助手和多模态生成式 AI 产品。

下载
  • Servlet 容器(如 Tomcat)为每个请求分配独立线程;
  • 每个线程拥有自己的 ThreadLocal,其中封装了唯一的 HttpServletRequest;
  • 各线程调用同一控制器实例的同一方法时,代理分别从各自 ThreadLocal 中取出对应 RequestContext 实例;
  • 因此:5 个请求 → 5 个线程 → 5 个独立 RequestContext 实例 → 彼此完全隔离,无状态竞争。

✅ 注意事项:

  • 必须启用作用域代理:使用 @RequestScope(proxyMode = ScopedProxyMode.TARGET_CLASS)(推荐 CGLIB 代理,支持任意类型)或在配置类中显式声明 @Bean + @Scope(proxyMode = ...);
  • 不要在非 Web 环境(如单元测试、定时任务)中直接依赖 @RequestScope Bean,否则会抛出 IllegalStateException: No thread-bound request found;
  • 避免在 @RequestScope Bean 中持有跨请求的可变状态(虽天然隔离,但语义上违背设计初衷)。

总之,Spring 的请求作用域并非“注入一个实例”,而是“注入一个智能代理”,它像一位精准的调度员,在每次方法调用时实时匹配当前线程所属的 HTTP 请求上下文,从而实现单例容器与请求级状态的无缝协同。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

作用域

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

3071

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

537

25

spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

3071

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

537

25

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

60

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

80

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
JavaScript高级框架设计视频教程
JavaScript高级框架设计视频教程

共22课时 | 4.4万人学习

前端学科面试题大全(第一季)
前端学科面试题大全(第一季)

共26课时 | 3.9万人学习