快捷導(dǎo)航

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

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

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

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

循環(huán)依賴（Circular Dependency） 是指兩個(gè)或多個(gè) Bean 相互直接或間接依賴，導(dǎo)致容器無法正常初始化這些 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)依賴的處理機(jī)制與 Spring 一致，但在 Spring Boot 2.6+ 版本中默認(rèn)禁止了循環(huán)依賴（通過 spring.main.allow-circular-references=false）。

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

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

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

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

直接報(bào)錯(cuò)：構(gòu)造函數(shù)注入的循環(huán)依賴無法解決，容器啟動(dòng)時(shí)拋出 BeanCurrentlyInCreationException。

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

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

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

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

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

以最初的ServiceA與ServiceB為例，

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

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

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

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

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

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

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

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

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

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

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

4. 調(diào)整注入方式

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

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

使用setter注入

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

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