引言

在Spring Boot開(kāi)發(fā)過(guò)程中，循環(huán)依賴（Circular Dependency）是一個(gè)常見(jiàn)但棘手的問(wèn)題。當(dāng)兩個(gè)或多個(gè)Bean相互依賴時(shí)，Spring容器無(wú)法確定初始化順序，導(dǎo)致應(yīng)用啟動(dòng)失敗。本文將通過(guò)兩個(gè)典型案例，深入分析循環(huán)依賴問(wèn)題的根源，并提供多種解決方案，幫助開(kāi)發(fā)者徹底理解和解決這類問(wèn)題。

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

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

• BeanA 依賴 BeanB
• BeanB 依賴 BeanC
• BeanC 又依賴 BeanA

Spring默認(rèn)禁止循環(huán)依賴，因?yàn)樗赡軐?dǎo)致不可預(yù)測(cè)的行為，如NPE（NullPointerException）或初始化順序問(wèn)題。

2. 案例一：Shiro與Service層的循環(huán)依賴

問(wèn)題分析

錯(cuò)誤日志如下：

The dependencies of some of the beans in the application context form a cycle:
   shirFilter → securityManager → userRealm → sysUserService → sysRoleService → sysUserService

這是一個(gè)典型的服務(wù)層與Shiro安全框架的循環(huán)依賴問(wèn)題：

• ShiroFilter 依賴 SecurityManager
• SecurityManager 依賴 UserRealm
• UserRealm 依賴 SysUserService
• SysUserService 依賴 SysRoleService
• SysRoleService 又依賴 SysUserService，形成閉環(huán)。

解決方案

(1) 重構(gòu)代碼，消除循環(huán)依賴（推薦）

// 將 SysUserService 和 SysRoleService 的相互依賴改為單向依賴
@Service
public class SysUserServiceImpl implements SysUserService {
    // 不再直接依賴 SysRoleService
    // 改為通過(guò)方法參數(shù)傳入
    public void someMethod(SysRoleService roleService) {
        // ...
    }
}

(2) 使用 @Lazy 延遲加載

@Service
public class SysUserServiceImpl implements SysUserService {
    @Lazy  // 延遲注入，避免循環(huán)依賴
    @Autowired
    private SysRoleService sysRoleService;
}

(3) 使用 Setter 注入替代字段注入

@Service
public class SysUserServiceImpl implements SysUserService {
    private SysRoleService sysRoleService;

    @Autowired  // 使用Setter注入，Spring會(huì)在Bean初始化后再注入依賴
    public void setSysRoleService(SysRoleService sysRoleService) {
        this.sysRoleService = sysRoleService;
    }
}

(4) 臨時(shí)啟用循環(huán)引用（不推薦）

# application.properties
spring.main.allow-circular-references=true

3. 案例二：PageHelper自動(dòng)配置循環(huán)依賴

問(wèn)題分析

錯(cuò)誤日志：

The dependencies of some of the beans in the application context form a cycle:
   com.github.pagehelper.autoconfigure.PageHelperAutoConfiguration

這個(gè)問(wèn)題通常是由于 PageHelper 版本與 Spring Boot 不兼容，或者自動(dòng)配置類自身存在循環(huán)引用。

解決方案

(1) 升級(jí) PageHelper 版本

<!-- pom.xml -->
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.4.6</version> <!-- 推薦使用最新穩(wěn)定版 -->
</dependency>

(2) 排除自動(dòng)配置

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

(3) 手動(dòng)配置 PageHelper

@Configuration
public class PageHelperConfig {
    @Bean
    public PageInterceptor pageInterceptor() {
        PageInterceptor interceptor = new PageInterceptor();
        Properties props = new Properties();
        props.setProperty("helperDialect", "mysql");
        props.setProperty("reasonable", "true");
        interceptor.setProperties(props);
        return interceptor;
    }
}

(4) 檢查依賴沖突

mvn dependency:tree

確保沒(méi)有引入多個(gè)不同版本的PageHelper。

4. 循環(huán)依賴的通用解決策略

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

最佳實(shí)踐

避免雙向依賴：盡量采用單向依賴，如 A → B，而不是 A ↔ B。

使用接口分離：將公共邏輯提取到單獨(dú)接口，減少耦合。

優(yōu)先使用構(gòu)造器注入：

@Service
public class MyService {
    private final OtherService otherService;
    
    @Autowired
    public MyService(OtherService otherService) {
        this.otherService = otherService;
    }
}

定期檢查依賴沖突：使用 mvn dependency:tree 或 gradle dependencies。

總結(jié)

循環(huán)依賴問(wèn)題雖然常見(jiàn)，但通過(guò)合理的架構(gòu)設(shè)計(jì)、依賴管理和Spring提供的機(jī)制（如@Lazy、Setter注入），可以有效解決。長(zhǎng)期來(lái)看，重構(gòu)代碼、優(yōu)化設(shè)計(jì)是最佳方案，而臨時(shí)方案（如allow-circular-references）僅適用于緊急修復(fù)。

到此這篇關(guān)于深度解析SpringBoot循環(huán)依賴問(wèn)題與解決的文章就介紹到這了,更多相關(guān)SpringBoot循環(huán)依賴內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論