外观
21 - Bean Scope 与作用域代理:实例到底共享到什么范围
适用版本:Spring Framework 6.x、Spring Boot 3.x。request、session 等 Web Scope 以 Servlet 应用为主。
摘要
同一个业务服务可以处理许多请求,但每个请求的上下文又需要彼此隔离。Spring 用 Scope(作用域)规定 Bean 在什么范围内复用:容器获取一个 Bean 时,是返回已有实例,还是创建新实例。
理解作用域,需要分清三个问题:实例在哪里复用、调用方何时取得实例、实例结束使用后由谁清理。singleton(单例)不是 JVM 全局单例,prototype(原型)也不代表对象会被自动销毁。短生命周期对象被长生命周期对象依赖时,还需要区分调用方持有的引用与当前实际使用的对象。ObjectProvider 可以让调用方按需获取对象;scoped proxy(作用域代理)则把方法调用转发给当前作用域中的目标对象。
1. 场景:为什么 request Bean 不能直接注入普通单例
设想 OrderService 是一个默认的 singleton Bean,要依赖每个 HTTP 请求各有一份的 RequestContext。服务可能在启动时就被创建,此时还没有请求;即使在某个请求中取得了真实上下文对象,也不能让服务一直持有它,否则后续请求仍会使用这一个对象。
下面是使用 @RequestScope 的类定义片段,需要 Servlet Web 应用、组件扫描,以及 Spring 注解和 java.util.UUID 的导入。它展示注入关系,不包含读取请求 ID 的业务方法。
java
@Component
@RequestScope
class RequestContext {
private final String requestId = UUID.randomUUID().toString();
}
@Service
class OrderService {
OrderService(RequestContext requestContext) { }
}这里的 @RequestScope 默认启用基于目标类的作用域代理,因此示例注入的是代理,而不是启动时就创建一个真实请求对象。代理是调用方与目标对象之间的包装对象:服务可以长期持有代理,调用需要访问目标的方法时,代理才从当前请求作用域取得真实对象。
因此,依赖注入可以在没有请求时完成,但访问真实目标仍需要当前线程拥有有效的请求上下文。代理解决的是“把目标查找推迟到调用时”,并没有把请求对象变成全局共享对象。
2. 常见 Scope
| Scope | 实例边界 | 销毁管理 | 典型用途 |
|---|---|---|---|
| singleton | 每个 BeanFactory、每个 Bean 名称一份 | 容器关闭时管理 | 无状态服务、共享基础设施 |
| prototype | 通常每次获取创建一份 | 容器通常不完整管理 | 短期、有状态对象 |
| request | 每个 HTTP 请求一份 | 请求结束 | 请求级上下文 |
| session | 每个 HTTP Session 一份 | Session 失效 | 少量会话状态 |
| application | 每个 ServletContext 一份 | Web 应用关闭 | Servlet 应用级共享状态 |
| 自定义 Scope | 由实现决定 | 由实现决定 | 租户、任务或工作流作用域 |
表中的实例边界针对同一个 Bean 定义。BeanFactory 是负责获取和创建 Bean 的容器接口,Bean 名称用于区分容器中的定义。因此,singleton 的共享边界是 BeanFactory 中的同一 Bean,而不是某个 Java 类在 ClassLoader(类加载器)、JVM 或集群中只能有一个对象。同一类注册为不同名称的 Bean,也不能仅凭类型相同就认定实例相同。
父子容器可以分别定义并持有同名 singleton;如果子容器没有自己的定义而从父容器取得 Bean,取得的则是父容器中的实例。多实例部署中的不同进程也不会共享这些内存对象。request、session、application 依赖 Web 作用域支持,不能在普通非 Web 容器中直接套用。
3. 长生命周期依赖短生命周期
3.1 直接注入 prototype 的陷阱
依赖注入通常发生在创建调用方 Bean 时,而不是每次执行它的业务方法时。下面用 prototype 看清这一区别。代码是类定义片段,需要组件扫描,并导入 Spring 的组件注解、Scope 和 ConfigurableBeanFactory。
java
@Component
@Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
class ReportTask { }
@Service
class ReportService {
private final ReportTask task;
ReportService(ReportTask task) {
this.task = task;
}
}构造 ReportService 时,容器为这个构造器参数获取一次 ReportTask,然后把得到的引用保存到 task 字段。以后使用该字段并没有再次向容器获取对象,因此这个 singleton 会长期持有同一个 ReportTask。prototype 的“每次获取创建新实例”针对容器获取动作,不会让已有字段在每次业务调用时自动刷新。
3.2 使用 ObjectProvider
如果希望每次生成报告都取得一个新任务,就把获取动作放到 generate() 中。以下片段替换上一节的 ReportService,继续使用同一个 prototype ReportTask,并需要导入 org.springframework.beans.factory.ObjectProvider。
java
@Service
class ReportService {
private final ObjectProvider<ReportTask> tasks;
ReportService(ObjectProvider<ReportTask> tasks) {
this.tasks = tasks;
}
void generate() {
ReportTask task = tasks.getObject();
// 使用本次取得的实例
}
}ObjectProvider<ReportTask> 是按需获取依赖的对象。注入 Provider 时不把某个任务固定到服务字段中;每次 generate() 执行 getObject(),才向容器获取任务。因为这里的 ReportTask 是 prototype,每次获取都会创建新实例。Provider 本身不会改变目标 Bean 的作用域:若目标是 singleton,重复获取仍会复用它。
这种方式让获取时机在业务代码中清晰可见,代价是业务类直接依赖 Spring 的 Provider API。Provider 的契约见08 - FactoryBean、BeanFactory 与 ObjectProvider。
3.3 使用 scoped proxy
作用域代理让调用方沿用普通依赖的调用方式,由代理负责查找目标。下面的类定义片段显式写出第一节 @RequestScope 的代理模式,需要导入 org.springframework.context.annotation.ScopedProxyMode;它与第一节的 RequestContext 是两种写法,不应作为同名类同时定义。
java
@Component
@RequestScope(proxyMode = ScopedProxyMode.TARGET_CLASS)
class RequestContext { }TARGET_CLASS 表示基于目标类创建代理。对于需要访问目标的方法调用,单例持有的代理会定位当前请求中的真实对象。同一请求内复用同一目标,不同请求使用各自的目标;“每次查找目标”不等于“每次调用都创建目标”。必须注意:
- 当前线程没有有效请求上下文时,调用需要访问目标的方法通常会抛作用域未激活异常;
- 把代理传给异步线程不会自动传播请求作用域;
- 代理类型和方法限制仍遵循 AOP(面向切面编程)的代理规则,不能假设所有方法访问都能被转发;
- 把真实 request 对象保存到静态变量或队列会让引用超出请求生命周期;保存代理也不会保存当时的请求上下文。
4. Scope 的容器实现
前面的复用规则在容器中体现为不同的获取分支。BeanDefinition 是描述 Bean 如何创建和配置的元数据,其中保存 scope 名称。AbstractBeanFactory#doGetBean() 根据 scope 决定从哪里获取或创建目标,下面是分支示意:
text
singleton → 单例注册表
prototype → 当前调用直接创建,并记录创建状态
其他 scope → Scope#get(name, ObjectFactory)对于其他作用域,容器把 Bean 名称和 ObjectFactory 交给对应的 Scope 实现。ObjectFactory 提供创建对象的入口,Scope 决定返回当前上下文已有的对象,还是调用工厂创建对象。这使“如何创建 Bean”与“在哪里保存和复用 Bean”分开。
自定义 Scope 需要定义对象获取、移除、销毁回调以及上下文标识等行为。销毁回调是对象结束使用时需要执行的清理动作;实现还必须明确作用域何时结束、何时移除引用并触发清理。只保存对象而没有结束与清理机制,会使 Scope 变成持续增长的缓存,甚至导致内存泄漏。
5. prototype 的销毁责任
Spring 会对 prototype 执行实例化、注入和初始化,但创建完成后通常不再跟踪其完整生命周期,因此不会像 singleton 一样在容器关闭时统一调用销毁回调。
如果 prototype 持有连接、文件或线程,调用方需要显式关闭,或重新设计为由受管理组件持有资源。@PreDestroy 用于声明销毁前执行的方法,但标注它不等于容器会自动跟踪并销毁 prototype。即使通过 Provider 每次取得了新实例,资源清理责任也不会因此消失。
6. 并发安全不是 Scope 自动提供的
singleton 可能被多个请求线程同时使用,因此共享的可变状态需要并发控制。request scope 减少了不同请求之间的实例共享,但同一请求中的对象仍可能被用于异步处理或并行任务;这不代表请求上下文会自动传播到这些线程。prototype 即使最初为一次获取单独创建,也可能随后被调用方交给多个线程使用。
Scope 只定义实例查找和生命周期边界,不自动保证线程安全。共享状态判断见并发 01 - 线程安全到底在保护什么。
7. 最小验证
以下是验证方案和预期结果。singleton、prototype 测试需要能够获取目标 Bean 的应用上下文;request 测试需要 Servlet 请求上下文,并在指定线程上绑定和结束请求。为目标 Bean 增加创建时生成且不再改变的实例 ID,通过可被代理转发的方法读取目标 ID,而不是只观察代理自身。分别验证同一个 Bean 定义:
- 同一上下文两次获取 singleton,ID 相同;
- 两次获取 prototype,ID 不同;
- 同一请求内两次调用 request proxy,目标 ID 相同;
- 两个独立请求中的目标 ID 不同;
- 无请求上下文的线程调用 request proxy 的目标方法明确失败;
- 为 singleton 和 prototype 配置销毁回调后,关闭上下文时 singleton 收到回调,prototype 不依赖容器自动销毁;若 prototype 持有资源,还应验证调用方的显式清理路径。
测试必须比较真实目标身份,不能只比较 scoped proxy 本身——代理通常是稳定的,变化的是它委托的作用域对象。
8. 排障清单
- BeanDefinition 的 scope 名称是什么?
- 当前比较的是代理身份还是真实目标身份?
- 长生命周期 Bean 是否固定持有了短生命周期实例?
- 当前线程是否存在所需 request/session 上下文?
- 异步边界是否错误携带或丢失了请求对象?
- prototype 或自定义 Scope 的资源由谁关闭?
- 父子 ApplicationContext 是否各自创建了同名 singleton?
9. 总结
Scope 决定对象在什么上下文中复用,作用域代理负责把长生命周期引用延迟解析到当前短生命周期目标。
- singleton 是容器内共享,不是 JVM 或集群全局唯一。
- prototype 注入 singleton 时不会自动做到每次调用创建新对象。
- request/session 代理不能跨线程凭空保留 Web 上下文。
阅读导航
- Bean 创建与 Scope 分支:03 - getBean() 背后的单例 Bean 创建链路
- 生命周期与销毁:05 - Bean 生命周期与扩展点顺序
- 延迟获取:08 - FactoryBean、BeanFactory 与 ObjectProvider
- 代理能力边界:09 - Spring AOP 如何创建代理
- 请求上下文与异步线程:并发 21 - 并发上下文传播与 ScopedValue