show: stepversion: 1.0
enable_checker: true

浅谈SpringFramework循环依赖问题

前言介绍

在前面的学习中,我们对Bean的创建有了一个粗略的了解,接着本文浅谈Spring循环依赖问题,这是一个面试比较常见的问题

什么是循环依赖?

所谓的循环依赖就是两个以及两个以上的类互相调用依赖,形成闭环

  1. // 类A依赖于B
  2. class A{
  3. public B b;
  4. }
  5. // 类B依赖了C
  6. class B{
  7. public C c;
  8. }
  9. // 类C依赖了A
  10. class C{
  11. public A a;
  12. }

在这里插入图片描述
然后?看起来是很正常的,我们随便new一个类,循环依赖的类都是能正常调用的

  1. A a = new A();
  2. System.out.println(a);

为什么?因为这种情况,A.java->A.class,我们new就能获取到实例的对象,这个通过jvm支持的,jdk是能支持这种情况的,不过本文不详细说明,本文要讨论的Spring中的bean,循环依赖在Spring中就是一个问题了
为什么?首先回顾一下之前的知识点,首先在Spring框架中类的创建都是给Spring IOC容器创建的,如图:
在这里插入图片描述
然后?真的出现这种情况,会怎么样?
在这里插入图片描述
Spring框架检测到这种场景会抛 BeanCurrentlyInCreationException,提前暴露对象的方法,因为Spring创建bean的过程是一个很复杂的过程,首先是xml解析为document对象,document对象再转成BeanDefinition,然后进行bean的生命周期,才算得上是一个真正的spring bean,接着进行后置处理器加工,假如出现这种,设想一下会怎么样?spring容器就会一直循环调用,当然是在特定的条件,为什么说是特定情况?请看下文

实验环境准备

实验环境:

  • SpringFramework版本
  • Springframework5.0.x
  • 开发环境
  • JAR管理:gradle 4.9/ Maven3.+
  • 开发IDE:IntelliJ IDEA 2018.2.5
  • JDK:jdk1.8.0_31
  • Git Server:Git fro window 2.8.3
  • Git Client:SmartGit18.1.5(可选)

循环依赖问题

我们可以通过例子进行验证,创建类A:

  1. package com.example.bean;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Component;
  4. /**
  5. *
  6. <pre>
  7. * A class
  8. * </pre>
  9. *
  10. *
  11. <pre>
  12. * @author mazq
  13. * 修改记录
  14. * 修改后版本: 修改人: 修改日期: 2020/11/05 10:31 修改内容:
  15. * </pre>
  16. */
  17. @Component
  18. public class A {
  19. //@Autowired
  20. B b;
  21. public A() {
  22. b = new B();
  23. System.out.println("A class is create");
  24. }
  25. }

类B:

  1. package com.example.bean;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Component;
  4. /**
  5. *
  6. <pre>
  7. * B class
  8. * </pre>
  9. *
  10. *
  11. <pre>
  12. * @author mazq
  13. * 修改记录
  14. * 修改后版本: 修改人: 修改日期: 2020/11/16 14:03 修改内容:
  15. * </pre>
  16. */
  17. @Component
  18. public class B {
  19. //@Autowired
  20. A a;
  21. public B() {
  22. a = new A();
  23. System.out.println("B class is create");
  24. }
  25. }

注册类A、B

  1. package com.example.config;
  2. import com.example.bean.B;
  3. import org.springframework.context.annotation.Bean;
  4. import org.springframework.context.annotation.Configuration;
  5. import com.example.bean.A;
  6. /**
  7. *
  8. <pre>
  9. * AppConfiguration
  10. * </pre>
  11. *
  12. *
  13. <pre>
  14. * @author mazq
  15. * 修改记录
  16. * 修改后版本: 修改人: 修改日期: 2020/11/05 10:26 修改内容:
  17. * </pre>
  18. */
  19. @Configuration
  20. public class AppConfiguration {
  21. @Bean
  22. public A a(){
  23. return new A();
  24. }
  25. @Bean
  26. public B b() {
  27. return new B();
  28. }
  29. }
  1. package com.example;
  2. import com.example.config.AppConfiguration;
  3. import org.springframework.context.annotation.AnnotationConfigApplicationContext;
  4. import com.example.bean.A;
  5. /**
  6. *
  7. <pre>
  8. * TestController
  9. * </pre>
  10. *
  11. *
  12. <pre>
  13. * @author mazq
  14. * 修改记录
  15. * 修改后版本: 修改人: 修改日期: 2020/11/05 10:22 修改内容:
  16. * </pre>
  17. */
  18. public class TestApplication {
  19. public static void testCircularReferences() {
  20. AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext();
  21. context.register(AppConfiguration.class);
  22. //context.setAllowCircularReferences(false);
  23. context.refresh();
  24. A bean = context.getBean(A.class);
  25. System.out.println(bean);
  26. }
  27. public static void main(String[] args) {
  28. // 测试Sprin循环依赖
  29. testCircularReferences();
  30. }
  31. }

经过测试,一直在循环调用:
在这里插入图片描述

循环依赖解决方法

对于这种情况,Spring有处理方法?答案是有的,方法就是通过@Autowired注解,当然bean要是单例的,多例的情况不支持,原因后面分析

  1. @Component
  2. public class A {
  3. @Autowired
  4. B b;
  5. public A() {
  6. System.out.println("A class is create");
  7. }
  8. }

在这里插入图片描述

补充:除了@Autowired方法,我们还可以通过set方法处理循环依赖问题,当然也是仅支持单例bean,多例的情况不支持

关闭Spring循环依赖

有个疑问?Spring的循环依赖支持,默认情况是开启?是否有什么开关控制?通过源码学习,可以通过setAllowCircularReferences设置

  1. AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext();
  2. context.register(AppConfiguration.class);
  3. // 关闭Spring循环依赖支持
  4. context.setAllowCircularReferences(false);
  5. context.refresh();

通过测试,设置不开启这个属性的时候,即使加上@Autowired,代码还是抛异常了

prototype(多例)循环依赖

在多例的情况,Spring能支持循环依赖?加上@Scope("prototype"),将bean变成多例的
在这里插入图片描述
经过测试:多例的情况会抛出异常,即使加上了@Autowired,原因请看下文

Spring循环依赖特征

ok,经过前面例子的验证,到这来,可以对Spring的循环依赖特点进行归纳:

  • Spring中的循环依赖场景
  • 构造器的循环依赖,通过构造函数
  • Field属性的循环依赖,通过set方法
  • Spring的循环依赖是默认开启的(setAllowCircularReferences)
  • Spring对单例和多例Bean的支持
  • 单例Bean(singleton) :只能通过@Autowired和set方法支持
  • 多例Bean(prototype):默认不支持,直接抛异常BeanCurrentlyInCreationException

Spring循环依赖原理

我们通过实验进行了验证,也归纳出了Spring循环依赖的特点,然后具体原因是什么?我们只能通过源码学习得到答案
上一章的学习中,我们对Bean的创建有了一个粗略的了解,所以,顺着这条路线,跟下源码:
在前面的学习,我们知道了{@link org.springframework.beans.factory.support.AbstractBeanFactory#doGetBean}这个方法就是Spring Bean创建的真正执行方法

  1. protected <T> T doGetBean(
  2. String name, @Nullable Class<T> requiredType, @Nullable Object[] args, boolean typeCheckOnly)
  3. throws BeansException {
  4. // 处理BeanName,前面说的FactoryBean带‘&’符号,要在这里进行转换
  5. String beanName = transformedBeanName(name);
  6. Object bean;
  7. // Eagerly check singleton cache for manually registered singletons.
  8. // 从map(singletonObjects)里获取单例bean,确定是否已经存在对应实例
  9. Object sharedInstance = getSingleton(beanName);
  10. if (sharedInstance != null && args == null) {
  11. if (logger.isDebugEnabled()) {
  12. if (isSingletonCurrentlyInCreation(beanName)) {
  13. logger.debug("Returning eagerly cached instance of singleton bean '" + beanName +
  14. "' that is not fully initialized yet - a consequence of a circular reference");
  15. }
  16. else {
  17. logger.debug("Returning cached instance of singleton bean '" + beanName + "'");
  18. }
  19. }
  20. // 两种情况:普通的bean,直接从singletonObjects返回sharedInstance
  21. //如果是FactoryBean,返回其创建的对象实例
  22. bean = getObjectForBeanInstance(sharedInstance, name, beanName, null);
  23. }
  24. else {
  25. // Fail if we're already creating this bean instance:
  26. // We're assumably within a circular reference.
  27. // 校验是否是多例(Prototype)的Bean,多例的bean是不支持循环依赖的
  28. // 为了避免循环依赖,遇到这种情况,直接抛出异常
  29. if (isPrototypeCurrentlyInCreation(beanName)) {
  30. throw new BeanCurrentlyInCreationException(beanName);
  31. }
  32. // Check if bean definition exists in this factory.
  33. // 检查BeanFactory是否存在这个BeanDefinition
  34. BeanFactory parentBeanFactory = getParentBeanFactory();
  35. if (parentBeanFactory != null && !containsBeanDefinition(beanName)) {
  36. // Not found -> check parent.
  37. // 当前容器找不到BeanDefinition,去parent容器查询
  38. String nameToLookup = originalBeanName(name);
  39. if (parentBeanFactory instanceof AbstractBeanFactory) {
  40. return ((AbstractBeanFactory) parentBeanFactory).doGetBean(
  41. nameToLookup, requiredType, args, typeCheckOnly);
  42. }
  43. else if (args != null) {
  44. // Delegation to parent with explicit args.
  45. // 返回parent容器的查询结果
  46. return (T) parentBeanFactory.getBean(nameToLookup, args);
  47. }
  48. else {
  49. // No args -> delegate to standard getBean method.
  50. return parentBeanFactory.getBean(nameToLookup, requiredType);
  51. }
  52. }
  53. if (!typeCheckOnly) {
  54. //typeCheckOnly为false的情况,将beanName放在一个alreadyCreated的集合
  55. markBeanAsCreated(beanName);
  56. }
  57. try {
  58. RootBeanDefinition mbd = getMergedLocalBeanDefinition(beanName);
  59. checkMergedBeanDefinition(mbd, beanName, args);
  60. // Guarantee initialization of beans that the current bean depends on.
  61. // 校验是否配置了 depends-on
  62. String[] dependsOn = mbd.getDependsOn();
  63. if (dependsOn != null) {
  64. for (String dep : dependsOn) {
  65. // 存在循环引用的情况,要抛出异常
  66. if (isDependent(beanName, dep)) {
  67. throw new BeanCreationException(mbd.getResourceDescription(), beanName,
  68. "Circular depends-on relationship between '" + beanName + "' and '" + dep + "'");
  69. }
  70. // 正常情况,注册依赖关系
  71. registerDependentBean(dep, beanName);
  72. try {
  73. // 初始化被依赖项
  74. getBean(dep);
  75. }
  76. catch (NoSuchBeanDefinitionException ex) {
  77. throw new BeanCreationException(mbd.getResourceDescription(), beanName,
  78. "'" + beanName + "' depends on missing bean '" + dep + "'", ex);
  79. }
  80. }
  81. }
  82. // Create bean instance.
  83. // 单例的Bean
  84. if (mbd.isSingleton()) {
  85. sharedInstance = getSingleton(beanName, () -> {
  86. try {
  87. // 创建单例bean
  88. return createBean(beanName, mbd, args);
  89. }
  90. catch (BeansException ex) {
  91. // Explicitly remove instance from singleton cache: It might have been put there
  92. // eagerly by the creation process, to allow for circular reference resolution.
  93. // Also remove any beans that received a temporary reference to the bean.
  94. destroySingleton(beanName);
  95. throw ex;
  96. }
  97. });
  98. bean = getObjectForBeanInstance(sharedInstance, name, beanName, mbd);
  99. }
  100. // 多例的Bean,scope = protoType
  101. else if (mbd.isPrototype()) {
  102. // It's a prototype -> create a new instance.
  103. Object prototypeInstance = null;
  104. try {
  105. // 多例的情况,创建bean之前添加标记(用于循环依赖校验)
  106. beforePrototypeCreation(beanName);
  107. // 执行多例Bean创建
  108. prototypeInstance = createBean(beanName, mbd, args);
  109. }
  110. finally {
  111. // 创建原型(多例)bean之后擦除标记
  112. afterPrototypeCreation(beanName);
  113. }
  114. bean = getObjectForBeanInstance(prototypeInstance, name, beanName, mbd);
  115. }
  116. // 如果不是单例bean也不是多例的bean,委托给对应的实现类
  117. else {
  118. String scopeName = mbd.getScope();
  119. if (!StringUtils.hasLength(scopeName)) {
  120. throw new IllegalStateException("No scope name defined for bean ´" + beanName + "'");
  121. }
  122. Scope scope = this.scopes.get(scopeName);
  123. if (scope == null) {
  124. throw new IllegalStateException("No Scope registered for scope name '" + scopeName + "'");
  125. }
  126. try {
  127. Object scopedInstance = scope.get(beanName, () -> {
  128. beforePrototypeCreation(beanName);
  129. try {
  130. // 执行bean创建
  131. return createBean(beanName, mbd, args);
  132. }
  133. finally {
  134. afterPrototypeCreation(beanName);
  135. }
  136. });
  137. bean = getObjectForBeanInstance(scopedInstance, name, beanName, mbd);
  138. }
  139. catch (IllegalStateException ex) {
  140. throw new BeanCreationException(beanName,
  141. "Scope '" + scopeName + "' is not active for the current thread; consider " +
  142. "defining a scoped proxy for this bean if you intend to refer to it from a singleton",
  143. ex);
  144. }
  145. }
  146. }
  147. catch (BeansException ex) {
  148. cleanupAfterBeanCreationFailure(beanName);
  149. throw ex;
  150. }
  151. }
  152. // Check if required type matches the type of the actual bean instance.
  153. // 检查一下类型是否正确,不正确抛出异常,正确返回实例
  154. if (requiredType != null && !requiredType.isInstance(bean)) {
  155. try {
  156. T convertedBean = getTypeConverter().convertIfNecessary(bean, requiredType);
  157. if (convertedBean == null) {
  158. throw new BeanNotOfRequiredTypeException(name, requiredType, bean.getClass());
  159. }
  160. return convertedBean;
  161. }
  162. catch (TypeMismatchException ex) {
  163. if (logger.isDebugEnabled()) {
  164. logger.debug("Failed to convert bean '" + name + "' to required type '" +
  165. ClassUtils.getQualifiedName(requiredType) + "'", ex);
  166. }
  167. throw new BeanNotOfRequiredTypeException(name, requiredType, bean.getClass());
  168. }
  169. }
  170. return (T) bean;
  171. }
  • 源码比较复杂,所以可以带着疑问来跟,首先以单例Bean的情况:#doGetBean.getSingleton
    在这里插入图片描述

在这里插入图片描述

  1. protected Object getSingleton(String beanName, boolean allowEarlyReference) {
  2. // 一级缓存:singletonObjects (单例池)
  3. Object singletonObject = this.singletonObjects.get(beanName);
  4. if (singletonObject == null && isSingletonCurrentlyInCreation(beanName)) {
  5. synchronized (this.singletonObjects) {
  6. // 二级缓存:earlySingletonObjects(BeanDefinition还没进行属性填充)
  7. singletonObject = this.earlySingletonObjects.get(beanName);
  8. if (singletonObject == null && allowEarlyReference) {
  9. // 三级缓存:singletonFactories
  10. ObjectFactory<?> singletonFactory = this.singletonFactories.get(beanName);
  11. if (singletonFactory != null) {
  12. singletonObject = singletonFactory.getObject();
  13. this.earlySingletonObjects.put(beanName, singletonObject);
  14. this.singletonFactories.remove(beanName);
  15. }
  16. }
  17. }
  18. }
  19. return singletonObject;
  20. }

在某些情况,循环依赖会造成循环调用,所以需要怎么解决?
在这里插入图片描述
Spring框架的方法是使用了三级缓存,其实最关键的是earlySingletonObjects

  • 一级缓存:singletonObjects,这是Spring BeanDefinition的单例池,首先只保存单例Bean的BeanDefinition,而且这个Bean是一个真正的bean,也就是进行过属性填充的
  • 二级缓存:earlySingletonObjects,early从单词意思来说,这个缓存是在singletonObjects之前的,也就是BeanDefinition还没进行属性填充等等操作,Spring引入这个缓存的目的就是为了处理单例bean的循环依赖问题
  • 三级缓存:singletonFactories,缓存的是ObjectFactory,表示对象工厂,为什么要加上这个缓存?原因比较复杂,涉及到AOP等等原因,因为我还没理解清楚,所以本文不说明

加上了earlySingletonObjects缓存之后,Spring就能支持单例bean的循环依赖,参考语雀某大佬的笔记,画图表示:
在这里插入图片描述

  • 带着疑问来跟一下多例Bean的情况:
    Spring框架是不支持多例bean的循环依赖的,原因跟下代码:#doGetBean ``` // Fail if we’re already creating this bean instance: // We’re assumably within a circular reference. // 校验是否是多例(Prototype)的Bean,多例的bean是不支持循环依赖的 // 为了避免循环依赖,遇到这种情况,直接抛出异常 if (isPrototypeCurrentlyInCreation(beanName)) { throw new BeanCurrentlyInCreationException(beanName); }
  1. 多例的情况:看代码是通过`prototypesCurrentlyInCreation`里的数据校验的,prototypesCurrentlyInCreation是一个`ThreadLocal`对象

protected boolean isPrototypeCurrentlyInCreation(String beanName) { Object curVal = this.prototypesCurrentlyInCreation.get(); return (curVal != null && (curVal.equals(beanName) || (curVal instanceof Set && ((Set<?>) curVal).contains(beanName)))); }

  1. 继续找代码,找到`beforePrototypeCreation`

protected void beforePrototypeCreation(String beanName) { Object curVal = this.prototypesCurrentlyInCreation.get(); if (curVal == null) { this.prototypesCurrentlyInCreation.set(beanName); } else if (curVal instanceof String) { Set beanNameSet = new HashSet<>(2); beanNameSet.add((String) curVal); beanNameSet.add(beanName); this.prototypesCurrentlyInCreation.set(beanNameSet); } else { Set beanNameSet = (Set) curVal; beanNameSet.add(beanName); } }

  1. Ctrl+Alt+H,查看这个方法的调用栈:其实就是在`#doGetBean`就调用了,也就是bean创建之前<br />
  2. ![在这里插入图片描述](.%5Cimages%5C20201116174501665.png)

try { // 多例的情况,创建bean之前添加标记(用于循环依赖校验) beforePrototypeCreation(beanName); // 执行多例Bean创建 prototypeInstance = createBean(beanName, mbd, args); } finally { // 创建原型(多例)bean之后擦除标记 afterPrototypeCreation(beanName); } bean = getObjectForBeanInstance(prototypeInstance, name, beanName, mbd);

```

知识点归纳

  • Spring中的循环依赖场景
  • 构造器的循环依赖,通过构造函数
  • Field属性的循环依赖,通过set方法
  • Spring的循环依赖是默认开启的(setAllowCircularReferences)
  • Spring对单例和多例Bean的支持
  • 单例Bean(singleton) :只能通过@Autowired和set方法支持
  • 多例Bean(prototype):默认不支持,直接抛异常BeanCurrentlyInCreationException
  • Spring支持单例bean的循环依赖原因:使用了三级缓存