Spring factory-method 实例化 Bean 详解:静态工厂、实例工厂与 FactoryBean 区别
1. 从一个真实报错说起:为什么要搞懂 factory-method
如果你写过一段时间的 Spring,大概率见过这个异常:
或者更让人摸不着头脑的:
这两个报错,十有八九都跟今天要聊的 factory-method 有关。很多人第一次接触它,是在看老项目 XML 配置的时候,看到 <bean factory-method="..."> 一脸懵:明明可以直接 new 一个对象,为什么还要绕一圈让 Spring 去调一个静态方法?还有人把它和 FactoryBean 搞混,面试的时候被追问一句“factory-method 和 FactoryBean 有什么区别”就卡壳了。
这篇内容就是围绕 Spring 通过 factory-method 实例化 Bean 这条主线展开的。我会把它的三种典型用法(静态工厂、实例工厂、结合 FactoryBean)、底层调用链路、参数传递方式、以及实际开发中最容易踩的坑,全部拆开讲清楚。适合已经会用 Spring 做基本开发、但对 Bean 实例化机制还停留在“加个 @Component 就完事”阶段的同学,也适合正在准备面试、想把 IoC 容器这块知识补扎实的朋友。看完之后,你应该能自己判断:什么场景下该用 factory-method,什么场景下用 FactoryBean 更合适,以及遇到那两类报错时该往哪个方向排查。
2. factory-method 到底是什么:三种实例化路径的定位
2.1 先厘清概念:Bean 的实例化方式不止一种
Spring 容器创建 Bean 实例,本质上就是“拿到一个对象”的过程。这个过程有好几条路可以走,常见的有:
- 构造器实例化:最常见,
<bean class="...">或@Component默认走的就是无参/有参构造。 - 静态工厂方法实例化:调用某个类的
static方法返回对象,配置里写factory-method,不写factory-bean。 - 实例工厂方法实例化:先有一个工厂 Bean,再调用它的普通方法返回对象,配置里同时写
factory-bean和factory-method。 - FactoryBean 实例化:实现
FactoryBean<T>接口,容器通过getObject()拿对象,这是 Spring 框架内部大量使用的机制。
factory-method 这个属性,覆盖的是中间两种:静态工厂和实例工厂。它的语义非常直白——告诉容器“别去调构造器了,去调这个方法拿对象”。
2.2 为什么要有 factory-method:封装复杂创建逻辑
你可能会问,直接 new 不行吗?大部分时候行,但有些场景不行:
第一种是创建逻辑复杂。比如一个连接池对象,创建时要读配置、初始化线程、预热连接,这些逻辑塞进构造器里会让类变得很脏,而且构造器没法返回“创建失败”的语义。用一个静态工厂方法 createPool(config) 就清爽很多。
第二种是需要返回子类或缓存对象。工厂方法可以根据参数决定返回哪个实现类,或者从缓存里拿已经存在的对象,构造器做不到这一点。
第三种是第三方类无法改造。你引入了一个 jar 包里的类,它没有公开构造器,只提供了一个静态方法 Xxx.getInstance(),这时候你没法给它加 @Component,只能通过 factory-method 把它纳入容器管理。
第四种是单例语义需要自己控制。有些老代码里,工厂方法内部维护了一个静态实例,Spring 再配 scope="singleton",两者叠加时要小心,后面会专门讲这个坑。
2.3 factory-method 与 FactoryBean 的区别,别搞混
这是面试高频点,也是实际开发容易用错的地方。简单说:
| 维度 | factory-method | FactoryBean |
|---|---|---|
| 配置位置 | bean 标签的属性 | 实现 FactoryBean 接口的类 |
| 谁被注册为 Bean | 工厂方法返回的对象 | FactoryBean 本身 + getObject 返回的对象 |
| 获取方式 | 直接按返回类型注入 | 按 &beanName 拿工厂本身,按 beanName 拿产品 |
| 典型用途 | 静态工具方法、第三方类 | 框架级复杂对象(如 SqlSessionFactory) |
| 是否感知容器 | 否 | 是,可实现 Aware 系列接口 |
一句话记忆:factory-method 是“借个方法造对象”,FactoryBean 是“我是一个专门造对象的 Bean”。前者更轻,后者更重但能力更强。
3. 静态工厂方法实例化:最常用的写法与细节
3.1 XML 配置的完整写法
先看最经典的静态工厂写法。假设有一个 ConnectionFactory 类:
XML 里这样配:
注意几个关键点:
class写的是工厂类,不是返回类型。factory-method写方法名,必须是static的。- 方法参数用
<constructor-arg>传,不是<property>。这一点很多人第一次会写错,因为直觉上觉得“方法参数”应该用别的标签,但 Spring 在这里复用了构造器参数的语义。
3.2 注解方式怎么写
纯注解场景下,静态工厂方法没有直接的注解等价物。你不能在方法上贴个 @Bean 就完事——那是 @Configuration 类里的实例方法。如果你确实想用注解风格,通常有两种做法:
第一种,写一个 @Configuration 类,里面用 @Bean 方法手动调用静态工厂:
第二种,如果工厂类是你自己写的,直接给它加 @Component,把创建逻辑放到构造器或 @PostConstruct 里。但如果是第三方类,就只能用上面这种包装方式。
提示:
@Bean方法默认也是走工厂方法语义的,只不过工厂是@Configuration类实例。所以从容器视角看,@Bean和factory-method在实例化阶段是同一类机制,区别在于工厂对象是容器管理的 Bean 还是普通类。
3.3 参数传递的坑:重载方法怎么选
静态工厂方法如果有重载,Spring 靠参数个数和类型来匹配。比如上面 createConnection() 和 createConnection(String) 两个方法,配置里写了 <constructor-arg> 就匹配带参的,没写就匹配无参的。
但这里有个隐蔽的坑:如果参数类型是模糊的,比如两个重载分别是 create(String) 和 create(Object),而你传的值是字符串,Spring 可能选不中你期望的那个。实测下来,Spring 的参数匹配是按声明顺序尝试的,遇到歧义时行为不一定符合直觉。稳妥做法是避免在工厂类里写参数类型过于接近的重载方法,或者用 @Bean 方式显式指定。
4. 实例工厂方法实例化:factory-bean 的配合使用
4.1 和静态工厂的核心差异
实例工厂方法要求工厂本身也是一个 Bean。配置上多了一个 factory-bean 属性,class 属性反而不能写了(因为工厂类已经在 factory-bean 指向的 Bean 里定义过了)。
4.2 为什么需要实例工厂:工厂本身要持有状态
静态工厂方法没法访问实例字段,所有逻辑必须是纯静态的。但现实中很多工厂需要持有配置、缓存、连接池引用等状态。比如一个 SqlSessionFactory 的构建,需要先有一个 Configuration 对象,这个对象是实例级别的。这时候实例工厂就派上用场了。
另一个典型场景是工厂方法需要访问 Spring 容器里的其他 Bean。静态方法拿不到注入的依赖,而实例工厂 Bean 可以被正常注入,方法内部就能用这些依赖。
4.3 一个容易忽略的细节:工厂 Bean 的生命周期
实例工厂方法有个微妙之处:工厂 Bean 本身也会经历完整的生命周期,包括实例化、属性注入、初始化回调。而产品 Bean 是在工厂方法被调用时才创建的。这意味着:
- 如果工厂 Bean 的
@PostConstruct里做了某些初始化,产品 Bean 创建时这些初始化已经完成。 - 如果工厂 Bean 是
prototype的,每次拿产品 Bean 都会新建一个工厂,这通常不是你想要的。 - 工厂 Bean 默认是单例,产品 Bean 的 scope 由产品 Bean 自己的配置决定,两者独立。
注意:不要给工厂 Bean 配
lazy-init="true"然后期望产品 Bean 也延迟。产品 Bean 的延迟由它自己的lazy-init控制,工厂 Bean 延迟只影响工厂本身的创建时机。
5. 底层调用链路:Spring 到底做了什么
5.1 从 getBean 到 instantiate 的路径
理解底层链路,排查问题时心里才有谱。当你调用 context.getBean("connection") 时,大致经过这些步骤:
AbstractBeanFactory.doGetBean检查缓存,没有则进入创建流程。createBean调用doCreateBean。createBeanInstance判断 BeanDefinition 里有没有factoryMethodName。- 如果有,进入
instantiateUsingFactoryMethod。 - 根据是否配置了
factoryBeanName,决定是静态调用还是先拿工厂 Bean 再调用。 - 方法返回的对象被包装成
BeanWrapper,继续走属性填充、初始化。
关键类和方法是 ConstructorResolver.instantiateUsingFactoryMethod,如果你去看源码,会发现它内部处理了参数解析、重载匹配、自动装配等一堆逻辑,比想象中复杂。
5.2 静态与实例在源码里的分叉点
在 instantiateUsingFactoryMethod 里,有一段判断:
这个分叉点解释了一个常见现象:实例工厂方法报错时,异常栈里往往先出现工厂 Bean 的创建异常。因为容器必须先成功创建工厂,才能调用它的方法。如果你看到 BeanCreationException 里嵌套了两层,外层是产品 Bean,内层是工厂 Bean,就是这个原因。
5.3 参数解析与类型转换
工厂方法的参数解析复用了构造器参数的那套机制,包括:
- 按类型匹配
- 按名称匹配(需要
-parameters编译参数或@ConstructorProperties) - 自动装配(
autowire="constructor"时) - 类型转换(字符串转数字、转枚举等)
这里有个实测经验:如果工厂方法参数是泛型或接口类型,自动装配可能选不中。比如方法签名是 create(DataSource ds),容器里有两个 DataSource Bean,就会抛 NoUniqueBeanDefinitionException。解决办法是用 @Qualifier 配合 @Bean 方式,或者改用实例工厂加 setter 注入。
6. 常见错误排查实录:从报错到定位
6.1 BeanNotOfRequiredTypeException 的三种成因
这个异常的字面意思是“拿到的 Bean 类型和期望不符”。在 factory-method 场景下,常见成因有:
成因一:工厂方法返回类型和声明类型不一致。 比如你按 Connection 类型注入,但工厂方法实际返回的是 Connection 的代理对象或子类,且没有正确暴露类型信息。Spring 在类型检查时会用 getTypeForFactoryMethod 推断返回类型,如果推断失败就退化成 Object。
成因二:FactoryBean 的 getObjectType 返回 null。 如果你用的是 FactoryBean 而不是 factory-method,getObjectType() 返回 null 会导致容器无法提前判断类型,注入时报类型不符。
成因三:AOP 代理干扰。 如果产品 Bean 被 AOP 代理了,实际类型是 CGLIB 子类,按原始类型注入一般没问题,但按接口注入时如果代理配置不当会出问题。
排查思路:先看异常信息里的 expected 和 actual,如果 actual 是 $$SpringCGLIB$$ 开头,基本是代理问题;如果是 Object,基本是类型推断失败。
6.2 NoSuchBeanDefinitionException 的排查清单
| 报错关键词 | 可能原因 | 排查动作 |
|---|---|---|
| No matching factory method | 方法名拼写错误或方法非 static | 检查方法签名和 static 修饰符 |
| No bean named 'xxx' | factory-bean 指向的 Bean 不存在 | 检查工厂 Bean 的 id 和扫描路径 |
| No default constructor | 工厂类没有无参构造 | 给工厂类加无参构造或改用静态工厂 |
| Ambiguous factory method | 重载方法无法区分 | 明确参数类型或减少重载 |
6.3 一个真实踩坑:静态工厂返回 null
有一次线上排查,某个 Bean 注入时报 NullPointerException,但容器启动没报错。最后定位到静态工厂方法在某种配置下返回了 null,而 Spring 对工厂方法返回 null 的处理是——允许。容器会把这个 null 当作 Bean 实例存起来,直到你使用它时才 NPE。
这个坑的教训是:工厂方法内部一定要做非空校验,返回 null 时主动抛异常,让问题在启动阶段暴露,而不是拖到运行时。
7. 实操心得与选型建议
7.1 什么时候该用 factory-method
我的经验是,满足以下条件之一时考虑它:
- 目标类来自第三方,无法加注解,且提供了静态工厂方法。
- 创建逻辑需要集中管理,且不依赖 Spring 容器里的其他 Bean。
- 需要根据运行时参数决定返回哪个实现。
反过来,如果创建逻辑需要注入其他 Bean,优先用 @Bean 方法;如果需要框架级的产品/工厂分离语义,用 FactoryBean。
7.2 和三级缓存、循环依赖的关系
factory-method 创建的 Bean 同样会进入三级缓存体系。但有个细节:提前暴露的早期引用是通过工厂方法拿到的对象,如果工厂方法每次返回新对象,循环依赖场景下可能出现两个不同实例。这也是为什么 Spring 官方建议工厂方法尽量返回单例语义的对象,除非你明确知道自己在做什么。
7.3 一个实用技巧:用 @Bean 模拟 factory-method 的可测试性
纯 XML 的 factory-method 配置在单元测试里不太好 mock。我的做法是把它迁移到 @Configuration 类里:
这样既保留了工厂方法的封装,又能享受注解配置的便利,测试时还可以用 @MockBean 替换依赖。迁移成本很低,收益却很明显。
最后分享一个排查小习惯:遇到 factory-method 相关问题时,先把日志级别调到 DEBUG,Spring 会打印出工厂方法的匹配过程和参数解析细节,比盲猜快得多。这个技巧帮我省过不少时间。