Spring bean的作用域

发表于 2020-02-22 更新于 2025-12-08 分类于学知识 Waline：阅读次数：

在Spring中，那些由IoC容器所管理的对象被称之为bean。而一个bean的定义，其实只是一个“蓝图”，指导着Spring如何去创建这样一个bean。而在这个蓝图中，有一个属性叫做“作用域”，它规定了这个bean的可见范围。这里我们看一下Spring的bean都有哪些作用域。

支持的作用域

我们先来看一下Spring支持哪些作用域。

作用域	说明
singleton	在Spring容器中仅存在一个bean的实例，bean以单例形式存在。这是默认的作用域
prototype	每次从容器中获取bean时，都将生成一个新的实例，即相当于每次都执行`new xxxBean()`
request	在HTTP请求(request)的完整生命周期中，将创建并使用单个实例。该作用域仅适用于`WebApplicatonContext`环境
session	在HTTP会话(session)的完整生命周期中，将创建并使用单个实例。该作用域仅适用于`WebApplicationContext`环境
globalSession	在全局的HTTP会话(session)的完整生命周期中，将创建并使用单个实例。该作用域仅适用于`WebApplicationContext`环境，且通常只能用在`Portlet`环境中。
application	在`ServletContext`的完整生命周期中，将创建并使用单个实例。该作用域仅适用于`WebApplicationContext`环境
websocket	在`WebSocket`的完整生命周期中，将创建并使用单个实例。该作用域仅适用于`WebApplicationContext`环境

指定bean的作用域

要指定一个bean的作用域，我们可以通过XML的方式或注解的方式来设定。

使用XML指定配置bean时，可以通过scope属性来指定作用域：

1	<bean id="someBean" class="com.demo.SomeClass" scope="singleton"/>

使用注解方式配置bean时，可以通过@Scope注解来指定作用域：

@Component
@Scope(ConfigurableBeanFactory.SCOPE_SINGLETON)
public class SomeClass {
    // Class definitions goes here
}

此外，如果使用注解方式配置作用域，Spring也提供了一系列常量值来方便我们配置：

// 在ConfigurableBeanFactory类中
String SCOPE_SINGLETON = "singleton";
String SCOPE_PROTOTYPE = "prototype";

// 在WebApplicationContext类中
String SCOPE_REQUEST = "request";
String SCOPE_SESSION = "session";
String SCOPE_APPLICATION = "application";

singleton作用域

singleton是Spring容器中的默认作用域。这个作用域下，容器中只创建各管理一个bean实例，实例存在于缓存中，并在后续对该bean的请求中都返回这个实例。

prototype作用域

与singleton正相反，每次对prototype作用域的bean的请求，Spring都会生成一个新的实例，即类似我们手动使用new XxxBean()方式创建实例。

需要注意的是，Spring不会完整的管理一个prototype的bean的生命周期。容器在初始化、配置，并将bean交由请求方(client)之后，就撒手不管了。也就是说，在销毁一个prototype的bean时，销毁bean的回调方法是不会被调用的，所以在销毁一个prototype的bean时，开发者必须手动释放它所使用的资源，或者可以尝试使用一个自定义的bean post-processor来让Spring做这些事。

对于有状态的bean，应当使用prototype作用域；对于无状态的bean，则应当使用singleton作用域。

向singleton bean注入prototype bean

因为bean的依赖关系在实例化bean时才会被解析，所以通常来说，我们不可以将一个prototype bean注入到一个singleton bean中。

如果我们向一个singleton bean中注入一个prototype bean，因为这个singleton bean只会被实例化一次，使得它的依赖也只会被注入一次，最终导致它依赖的那个singleton bean也只存在一个实例。

request、session、global session、application和websocket作用域

这几种作用域只能用在web-aware的Spring上下文中，比如XmlWebApplicationContext。如果用在一般的IoC容器中，比如ClassPathXmlApplicationContext中，那么容器会抛出一个IllegalStateException。

要使用这几个作用域，你可能需要对你的应用进行一些配置。因为这些内容与本文无关，所以在这里就不详细说明了。感兴趣的话可以看Spring参考手册中的内容。

注：web-aware这个词，我也不知道怎么翻译才合适。查阅了一些资料之后，感觉一个web-aware的Spring应用就是一个运行在web容器(比如Tomcat)中的应用，因为上面提到的这些作用域也是与web应用相关的。如果有好的理解，请一定在留言区写下来让在下知道。

request作用域

request作用域下的bean，在每次HTTP请求中，都会创建一个新的实例。当请求完成时，对应的bean就会被销毁。对一个实例的任何更改，对其他的所有实例来说都是不可见的。

session作用域

session作用域下的bean，在每个活动的HTTP会话中，都有一个独自的实例，而当会话结束后，对应的bean就会被销毁。对一个实例的任何更改，对其他所有的实例来说都是不可见的。

globalSession作用域

这个作用域只能用在portlet应用中。一个portlet站点中可能有多个portlet应用，而它们相关的session中都会共享同一个globalSession作用域的bean。

注：其实我也不知道portlet到底是个啥，就算看过维基百科的Portlet条目也没看明白。

application作用域

在整个应用范围内，容器为每个web应用程序运行时创建一个实例。这个作用域与singleton很类似，但是还是有两个不同点：

在不同ServletContext中有不同的bean单例对象；singleton作用域的bean是每个ApplicationContext的单例对象。而一个应用可能有多个ApplicationContext
bean作为ServletContext属性可见

[^1]: Bean Scopes - The IoC container
[^2]: Spring系列四：Bean Scopes作用域
[^3]: Spring学习（十五）Spring Bean 的5种作用域介绍