Springboot循環(huán)依賴的原因及解決

更新時間：2025年05月07日 11:05:47 作者：帝錦_li

本文主要介紹了Spring Boot中的循環(huán)依賴問題,包括循環(huán)依賴的定義、產(chǎn)生原因以及解決方法,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

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

循環(huán)依賴（Circular Dependency） 是指兩個或多個 Bean 相互直接或間接依賴，導致容器無法正常初始化這些 Bean。

@Service
public class ServiceA {
    @Autowired
    private ServiceB serviceB; // ServiceA 依賴 ServiceB
}

@Service
public class ServiceB {
    @Autowired
    private ServiceA serviceA; // ServiceB 依賴 ServiceA
}

Spring Boot 基于 Spring 框架，其循環(huán)依賴的處理機制與 Spring 一致，但在 Spring Boot 2.6+ 版本中默認禁止了循環(huán)依賴（通過 spring.main.allow-circular-references=false）。

產(chǎn)生循環(huán)依賴的原因

1.構造函數(shù)注入循環(huán)依賴：

@Service
public class ServiceA {
    private final ServiceB serviceB;
    public ServiceA(ServiceB serviceB) { // 構造函數(shù)注入
        this.serviceB = serviceB;
    }
}

@Service
public class ServiceB {
    private final ServiceA serviceA;
    public ServiceB(ServiceA serviceA) { // 構造函數(shù)注入
        this.serviceA = serviceA;
    }
}

直接報錯：構造函數(shù)注入的循環(huán)依賴無法解決，容器啟動時拋出 BeanCurrentlyInCreationException。

2.Setter/Field 注入循環(huán)依賴：

在spring中使用@Autowired注解標簽進行自動注入,如果不加以處理,會出現(xiàn)循環(huán)依賴問題。

怎么解決循環(huán)依賴

在Springboot2.5以前可以通過三級緩存解決單例 Bean 的循環(huán)依賴問題。

緩存名稱	職責
`singletonObjects`	存放完全初始化好的 Bean（一級緩存）
`earlySingletonObjects`	存放提前暴露的早期 Bean（二級緩存）
`singletonFactories`	存放 Bean 的工廠對象（三級緩存）

以最初的ServiceA與ServiceB為例，

創(chuàng)建 ServiceA，通過工廠將其半成品引用存入三級緩存。
ServiceA 注入 ServiceB，觸發(fā) ServiceB 的創(chuàng)建。
創(chuàng)建 ServiceB，同樣將其半成品引用存入三級緩存。
ServiceB 注入 ServiceA 時，從三級緩存中獲取 ServiceA 的早期引用，完成 ServiceB 的初始化。
ServiceB 初始化完成后，ServiceA 完成依賴注入，最終初始化。

出現(xiàn)循環(huán)依賴之后的幾個解決思路：

1.避免循環(huán)依賴（推薦）

重構代碼：將公共邏輯抽離到第三個 Bean 中。
使用接口或抽象類：通過面向接口編程解耦具體實現(xiàn)。

2. 允許循環(huán)依賴（臨時方案）

在 application.properties 中顯式允許循環(huán)依賴：

# Spring Boot 2.6+ 需要手動開啟
spring.main.allow-circular-references=true

這種只適用于Springboot版本在2.6以上的循環(huán)依賴被禁止的情形。

3. 使用 `@Lazy` 延遲加載

在其中一個依賴上添加 @Lazy，延遲注入 Bean 的初始化：

@Service
public class ServiceA {
    @Lazy
    @Autowired
    private ServiceB serviceB; // 延遲初始化 ServiceB
}

4. 調整注入方式

優(yōu)先使用 Setter/Field 注入：避免構造函數(shù)注入導致的不可解循環(huán)依賴。

@Service
public class ServiceA {
    private ServiceB serviceB;
    
    @Autowired
    public void setServiceB(ServiceB serviceB) { // Setter 注入
        this.serviceB = serviceB;
    }
}

使用setter注入

循環(huán)依賴的局限性

構造函數(shù)注入無法解決循環(huán)依賴：Spring 容器在創(chuàng)建 Bean 時需先完成構造函數(shù)調用，此時依賴的 Bean 尚未初始化。
原型（Prototype）作用域的 Bean：Spring 不管理原型 Bean 的完整生命周期，無法解決其循環(huán)依賴。
AOP 代理問題：如果 Bean 被 AOP 代理（如 @Async、@Transactional），可能導致循環(huán)依賴解決失敗。