引言

在Spring Boot開發(fā)中，依賴注入（DI）是核心特性之一，它幫助我們構(gòu)建松耦合、可測試的應(yīng)用程序。然而，當(dāng)多個Bean相互依賴時，可能會形成循環(huán)依賴（Circular Dependency），導(dǎo)致應(yīng)用啟動失敗。

本文將通過一個實際錯誤案例，深入分析Spring Boot循環(huán)依賴的成因、解決方案，并提供最佳實踐建議，幫助開發(fā)者避免此類問題。

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

1.1 循環(huán)依賴的定義

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

• ServiceA 依賴 ServiceB
• ServiceB 依賴 ServiceC
• ServiceC 又依賴 ServiceA

這樣就會形成一個循環(huán)鏈，Spring在初始化時無法決定哪個Bean應(yīng)該先創(chuàng)建。

1.2 Spring Boot的默認(rèn)行為

在Spring Boot 2.6+版本中，循環(huán)依賴默認(rèn)被禁止，如果檢測到循環(huán)依賴，會拋出如下錯誤：

APPLICATION FAILED TO START
*
Description:
The dependencies of some of the beans in the application context form a cycle:
...
Action:
Relying upon circular references is discouraged and they are prohibited by default.

2. 案例分析：循環(huán)依賴的錯誤日志

以下是本文討論的錯誤日志：

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.

*
APPLICATION FAILED TO START
*

Description:
The dependencies of some of the beans in the application context form a cycle:

   afterTestController → AfterTestService → OpmMediaFlowControlService → OpmOperateTeamService → SysChannelCompanyService → OpmChannelAccountService → SysChannelCompanyService

依賴鏈分析：

• AfterTestController 依賴 AfterTestService
• AfterTestService 依賴 OpmMediaFlowControlService
• OpmMediaFlowControlService 依賴 OpmOperateTeamService
• OpmOperateTeamService 依賴 SysChannelCompanyService
• SysChannelCompanyService 依賴 OpmChannelAccountService
• OpmChannelAccountService 又依賴 SysChannelCompanyService（形成閉環(huán)）

3. 解決方案

3.1 方案1：重構(gòu)代碼（推薦）

最佳實踐是避免循環(huán)依賴，通?？梢酝ㄟ^以下方式重構(gòu)：

(1) 提取公共邏輯到新Service

如果兩個Service需要互相調(diào)用，可以將公共邏輯提取到第三個Service：

@Service
public class CommonService {
    // 公共方法
}

(2) 使用接口或事件驅(qū)動模式

接口分離：讓Service依賴接口，而不是具體實現(xiàn)。

事件驅(qū)動：使用Spring的ApplicationEvent解耦：

@Service
public class ServiceA {
    @Autowired
    private ApplicationEventPublisher eventPublisher;

    public void doSomething() {
        eventPublisher.publishEvent(new CustomEvent(data));
    }
}

@Component
public class ServiceB {
    @EventListener
    public void handleEvent(CustomEvent event) {
        // 處理事件
    }
}

3.2 方案2：使用@Lazy注解（次優(yōu)方案）

如果暫時無法重構(gòu)，可以在其中一個依賴上使用@Lazy，延遲初始化Bean：

@Service
public class ServiceA {
    @Lazy  // 延遲注入
    @Autowired
    private ServiceB serviceB;
}

缺點：

• 只是延遲問題，而不是真正解決循環(huán)依賴。
• 可能導(dǎo)致運行時NPE（NullPointerException）。

3.3 方案3：允許循環(huán)依賴（臨時方案）

如果必須保留循環(huán)依賴，可以在application.properties中啟用：

spring.main.allow-circular-references=true

缺點：

• 只是繞過問題，可能導(dǎo)致不可預(yù)見的初始化順序問題。
• 不推薦在生產(chǎn)環(huán)境使用。

4. 深入理解Spring的循環(huán)依賴處理機制

4.1 Spring的三級緩存

Spring通過三級緩存解決部分循環(huán)依賴問題：

• Singleton Objects（一級緩存）：存放完全初始化好的Bean。
• Early Singleton Objects（二級緩存）：存放半成品Bean（已實例化但未初始化）。
• Singleton Factories（三級緩存）：存放Bean工廠，用于生成代理對象。

4.2 循環(huán)依賴的解決條件

• 僅適用于單例（Singleton）作用域的Bean。
• 僅適用于字段注入（@Autowired）或Setter注入，不適用于構(gòu)造器注入。

5. 最佳實踐總結(jié)

推薦做法：

• 避免雙向依賴，盡量采用單向依賴（Controller → Service → Repository）。
• 提取公共邏輯到新Service或Utils類。
• 使用事件驅(qū)動（ApplicationEvent）解耦Service。
• 盡量使用構(gòu)造器注入，避免字段注入（能提前發(fā)現(xiàn)循環(huán)依賴問題）。

6. 示例代碼：重構(gòu)后的結(jié)構(gòu)

6.1 原結(jié)構(gòu)（循環(huán)依賴）

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

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

6.2 重構(gòu)后（解耦）

// 提取公共邏輯到新Service
@Service
public class CommonService {
    // 公共方法
}

// ServiceA 依賴 CommonService
@Service
public class ServiceA {
    @Autowired
    private CommonService commonService;
}

// ServiceB 依賴 CommonService
@Service
public class ServiceB {
    @Autowired
    private CommonService commonService;
}

7. 結(jié)論

循環(huán)依賴是Spring Boot開發(fā)中的常見問題，通常表明設(shè)計上存在優(yōu)化空間。雖然可以通過@Lazy或allow-circular-references臨時解決，但重構(gòu)代碼才是最佳實踐。

關(guān)鍵點總結(jié)：

• 避免雙向依賴，盡量保持單向依賴鏈。
• 優(yōu)先使用構(gòu)造器注入，能更早發(fā)現(xiàn)循環(huán)依賴問題。
• 提取公共邏輯或使用事件驅(qū)動解耦Service。
• 不要濫用@Lazy或allow-circular-references，它們只是臨時解決方案。

通過合理設(shè)計，我們可以構(gòu)建更健壯、可維護的Spring Boot應(yīng)用！ 

以上就是SpringBoot中循環(huán)依賴問題的原理與解決方案的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot循環(huán)依賴問題的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論