SmartInstantiationAwareBeanPostProcessor 是 InstantiationAwareBeanPostProcessor 的扩展接口,新增 predictBeanType、determineCandidateConstructors 和 getEarlyBeanReference 三个方法,专用于构造器推断、早期引用生成及类型预测,是 Spring 解决单例循环依赖和构造器注入的核心机制。

SmartInstantiationAwareBeanPostProcessor 是什么,它和 InstantiationAwareBeanPostProcessor 有什么区别
它不是“增强版”或“升级版”,而是 Spring 内部用于解决构造器推断(constructor resolution)和早期 Bean 引用(early bean reference)的关键接口。如果你没遇到循环依赖、@Autowired 构造器注入失败、或需要在 Bean 实例化前就确定用哪个构造器,大概率用不到它。
核心差异在于三个新增方法:predictBeanType、determineCandidateConstructors、getEarlyBeanReference。前两者影响 Spring 如何选构造器,最后一个直接影响三级缓存中存放的早期引用对象——这是解决单例 Bean 循环依赖的底层机制。
它继承自 InstantiationAwareBeanPostProcessor,所以所有它的方法都可用,但真正“深度干预”的能力来自这三个新增方法。
什么时候必须重写 determineCandidateConstructors
当你的 Bean 有多个构造器,且 Spring 默认的推断逻辑无法满足需求时。比如:你希望 Spring 在实例化 UserService 时,优先选择带 DataSource 和 RedisTemplate 的构造器,而不是无参或仅含 DataSource 的那个。
- Spring 默认只看 @Autowired 标注的构造器;若没标注,就选参数最多的那个;若参数数相同,会抛
NoUniqueBeanDefinitionException - 你可以在
determineCandidateConstructors中返回明确的构造器数组,强制指定 - 返回
null表示不干预,走 Spring 默认逻辑;返回空数组表示禁止实例化(会抛异常) - 注意:该方法在
postProcessBeforeInstantiation之后、真正调用构造器之前触发,是构造器选择的最终决策点
getEarlyBeanReference 被忽略的常见原因
这个方法只对 singleton 作用域的 Bean 生效,且仅在存在循环依赖、Spring 正在构建三级缓存(singletonFactories)时才会调用。如果你发现它没执行,大概率是以下情况之一:
- 目标 Bean 是
prototype作用域 —— 它不参与三级缓存,该方法直接跳过 - 没有发生循环依赖 —— 比如 A 依赖 B,B 不依赖 A,那 A 创建时不会提前暴露早期引用,也就不会调用此方法
- 你注册的处理器未被容器识别 —— 必须通过
@Component或手动addBeanPostProcessor注入,且不能晚于AbstractAutowireCapableBeanFactory初始化 - 在
getEarlyBeanReference中返回了null—— Spring 会认为你拒绝提供早期引用,后续循环依赖检查直接失败
典型用途是给早期 Bean 加代理(如 AOP),但要注意:此时 Bean 还没完成属性注入,所以不能依赖任何被 @Autowired 的字段。
为什么 predictBeanType 很少被重写,但改了会影响整个流程
它在 BeanFactory 解析 BeanDefinition 阶段就被调用,早于任何实例化动作。Spring 用它来预判 Bean 最终类型,影响:
- 泛型擦除后的实际类型匹配(比如
List<string></string>注入时能否匹配到ArrayList) - @ConditionalOnBean 等条件注解的判断结果
- FactoryBean#getObjectType() 的 fallback 行为
重写它风险很高:一旦返回类型与真实实例类型不一致(比如返回 InterfaceA,但最终 new 出来的是 ImplB),可能导致依赖注入失败或 ClassCastException。除非你在做高度定制的 FactoryBean 或泛型桥接,否则别碰它。
真正容易被忽略的复杂点是:这三个方法的执行顺序和上下文隔离性。比如 determineCandidateConstructors 返回的构造器,会被后续所有实例化路径复用;而 getEarlyBeanReference 返回的对象,如果带状态,可能被多个正在创建的 Bean 共享——这在高并发 Bean 创建场景下容易引发意料外的状态污染。

















