快捷導(dǎo)航

springboot循環(huán)依賴問(wèn)題案例代碼及解決辦法

更新時(shí)間：2025年04月03日 14:50:19 作者：學(xué)亮編程手記

在 Spring Boot 中,如果兩個(gè)或多個(gè) Bean之間存在循環(huán)依賴（即 Bean A 依賴 Bean B,而 Bean B 又依賴 Bean A）,會(huì)導(dǎo)致 Spring 的依賴注入機(jī)制無(wú)法正確處理,從而拋出異常,下面給大家介紹springboot循環(huán)依賴問(wèn)題及其解決辦法,感興趣的朋友一起看看吧

在 Spring Boot 中，如果兩個(gè)或多個(gè) Bean 之間存在循環(huán)依賴（即 Bean A 依賴 Bean B，而 Bean B 又依賴 Bean A），會(huì)導(dǎo)致 Spring 的依賴注入機(jī)制無(wú)法正確處理，從而拋出異常。以下是循環(huán)依賴的場(chǎng)景分析、案例代碼及常見的解決方法。

1. 什么是循環(huán)依賴？

概念

循環(huán)依賴是指兩個(gè)或多個(gè) Bean 相互依賴，形成一個(gè)閉環(huán)。例如：

直接循環(huán)依賴：
- A 依賴 B，B 依賴 A。
間接循環(huán)依賴：
- A 依賴 B，B 依賴 C，而 C 又依賴 A。

2. 循環(huán)依賴的場(chǎng)景案例

以下是一個(gè)簡(jiǎn)單的直接循環(huán)依賴場(chǎng)景。

案例代碼 Bean A

@Component
public class BeanA {
    @Autowired
    private BeanB beanB;
    public BeanA() {
        System.out.println("BeanA Constructor");
    }
    public void doSomething() {
        System.out.println("BeanA is doing something");
    }
}

Bean B

@Component
public class BeanB {
    @Autowired
    private BeanA beanA;
    public BeanB() {
        System.out.println("BeanB Constructor");
    }
    public void doSomething() {
        System.out.println("BeanB is doing something");
    }
}

啟動(dòng)類

@SpringBootApplication
public class CircularDependencyDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(CircularDependencyDemoApplication.class, args);
    }
}

運(yùn)行結(jié)果

運(yùn)行時(shí)，Spring 會(huì)拋出以下異常：

Caused by: org.springframework.beans.factory.BeanCurrentlyInCreationException:
Error creating bean with name 'beanA':
Requested bean is currently in creation: Is there an unresolvable circular reference?

3. 解決循環(huán)依賴的常見方法

方法 1：使用 @Lazy 注解

@Lazy 注解可以延遲加載 Bean，使 Spring 在真正需要使用時(shí)才注入依賴，從而打破循環(huán)依賴。

修改代碼

在其中一個(gè)依賴上添加 @Lazy 注解：

BeanA:

@Component
public class BeanA {
    @Autowired
    @Lazy
    private BeanB beanB;
    public BeanA() {
        System.out.println("BeanA Constructor");
    }
    public void doSomething() {
        System.out.println("BeanA is doing something");
    }
}

BeanB:

@Component
public class BeanB {
    @Autowired
    private BeanA beanA;
    public BeanB() {
        System.out.println("BeanB Constructor");
    }
    public void doSomething() {
        System.out.println("BeanB is doing something");
    }
}

運(yùn)行結(jié)果

程序運(yùn)行正常，輸出：

BeanA Constructor
BeanB Constructor

方法 2：使用構(gòu)造器注入解決循環(huán)依賴

Spring 無(wú)法通過(guò)構(gòu)造器注入解決循環(huán)依賴，因?yàn)樵跇?gòu)造器注入的過(guò)程中，所有依賴必須在實(shí)例化時(shí)完全注入。這種情況下，需要重新設(shè)計(jì)代碼結(jié)構(gòu)以打破循環(huán)依賴。

重構(gòu)代碼

將循環(huán)依賴重構(gòu)為單向依賴。例如，可以引入第三方協(xié)作者 Bean 來(lái)解耦。

BeanA：

@Component
public class BeanA {
    private final Helper helper;
    public BeanA(Helper helper) {
        this.helper = helper;
        System.out.println("BeanA Constructor");
    }
    public void doSomething() {
        System.out.println("BeanA is doing something");
    }
}

BeanB：

@Component
public class BeanB {
    private final Helper helper;
    public BeanB(Helper helper) {
        this.helper = helper;
        System.out.println("BeanB Constructor");
    }
    public void doSomething() {
        System.out.println("BeanB is doing something");
    }
}

Helper：

@Component
public class Helper {
    public void assist() {
        System.out.println("Helper is assisting");
    }
}

運(yùn)行結(jié)果

Helper Constructor
BeanA Constructor
BeanB Constructor

通過(guò)引入 Helper，BeanA 和 BeanB 不再直接依賴彼此，循環(huán)依賴被消除。

方法 3：使用 @PostConstruct 或 Setter 注入

通過(guò)構(gòu)造器注入會(huì)導(dǎo)致循環(huán)依賴問(wèn)題，但可以使用 Setter 方法注入來(lái)延遲依賴注入的時(shí)機(jī)。

修改代碼

BeanA：

@Component
public class BeanA {
    private BeanB beanB;
    public BeanA() {
        System.out.println("BeanA Constructor");
    }
    @Autowired
    public void setBeanB(BeanB beanB) {
        this.beanB = beanB;
    }
    public void doSomething() {
        System.out.println("BeanA is doing something");
    }
}

BeanB：

@Component
public class BeanB {
    private BeanA beanA;
    public BeanB() {
        System.out.println("BeanB Constructor");
    }
    @Autowired
    public void setBeanA(BeanA beanA) {
        this.beanA = beanA;
    }
    public void doSomething() {
        System.out.println("BeanB is doing something");
    }
}

運(yùn)行結(jié)果

BeanA Constructor
BeanB Constructor

Setter 注入允許 Spring 在實(shí)例化 Bean 后再設(shè)置依賴，從而避免循環(huán)依賴問(wèn)題。

方法 4：使用 ObjectFactory 或 Provider 進(jìn)行延遲注入

Spring 提供了 ObjectFactory 和 Provider 接口，用于延遲獲取 Bean，從而避免循環(huán)依賴。

修改代碼 BeanA：

@Component
public class BeanA {
    private final ObjectFactory<BeanB> beanBFactory;
    public BeanA(ObjectFactory<BeanB> beanBFactory) {
        this.beanBFactory = beanBFactory;
        System.out.println("BeanA Constructor");
    }
    public void doSomething() {
        BeanB beanB = beanBFactory.getObject();
        System.out.println("BeanA is doing something with " + beanB);
    }
}

BeanB：

@Component
public class BeanB {
    private final BeanA beanA;
    @Autowired
    public BeanB(BeanA beanA) {
        this.beanA = beanA;
        System.out.println("BeanB Constructor");
    }
    public void doSomething() {
        System.out.println("BeanB is doing something");
    }
}

運(yùn)行結(jié)果

BeanA Constructor
BeanB Constructor

通過(guò) ObjectFactory，BeanA 可以在需要時(shí)動(dòng)態(tài)獲取 BeanB，避免了循環(huán)依賴。

方法 5：使用 @DependsOn 明確加載順序

如果循環(huán)依賴是因?yàn)?Bean 的加載順序問(wèn)題，可以使用 @DependsOn 指定加載順序。

修改代碼

BeanA：

@Component
@DependsOn("beanB") // 指定 BeanB 應(yīng)該先加載
public class BeanA {
    @Autowired
    private BeanB beanB;
    public BeanA() {
        System.out.println("BeanA Constructor");
    }
    public void doSomething() {
        System.out.println("BeanA is doing something");
    }
}

BeanB：

@Component
public class BeanB {
    @Autowired
    private BeanA beanA;
    public BeanB() {
        System.out.println("BeanB Constructor");
    }
    public void doSomething() {
        System.out.println("BeanB is doing something");
    }
}

運(yùn)行結(jié)果