快捷導(dǎo)航

SpringBoot中循環(huán)依賴問題的原理與解決方案

更新時間：2025年07月06日 08:53:15 作者：碼農(nóng)阿豪@新空間

在Spring Boot開發(fā)中,依賴注入（DI）是核心特性之一,本文將通過一個實際錯誤案例,深入分析Spring Boot循環(huán)依賴的成因、解決方案,并提供最佳實踐建議,希望對大家有所幫助

引言

在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)依賴處理機(jī)制

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é)

方案	適用場景	優(yōu)點	缺點
重構(gòu)代碼	長期項目	徹底解決問題，代碼更清晰	需要設(shè)計調(diào)整
@Lazy注解	短期修復(fù)	簡單快捷	可能隱藏問題
允許循環(huán)依賴	緊急修復(fù)	快速繞過問題	不推薦，可能導(dǎo)致未知錯誤

推薦做法：

避免雙向依賴，盡量采用單向依賴（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;
}