引言

在使用 Spring Boot 開(kāi)發(fā)項(xiàng)目時(shí)，我們經(jīng)常會(huì)遇到一個(gè)令人頭疼的問(wèn)題——依賴(lài)循環(huán)（Circular Dependency）。當(dāng)兩個(gè)或多個(gè) Bean 相互依賴(lài)，形成閉環(huán)時(shí)，Spring 容器就無(wú)法完成它們的初始化，從而拋出 BeanCurrentlyInCreationException 異常。

本文將通過(guò)一個(gè)具體案例，深入剖析依賴(lài)循環(huán)是如何產(chǎn)生的，并提供多種實(shí)用的解決方案，幫助你徹底掌握這一常見(jiàn)問(wèn)題的應(yīng)對(duì)之道。

一、什么是依賴(lài)循環(huán)？

依賴(lài)循環(huán)是指兩個(gè)或多個(gè) Spring Bean 在構(gòu)造函數(shù)或字段注入時(shí)互相依賴(lài)，形成一個(gè)閉環(huán)。例如：

• A 依賴(lài) B
• B 依賴(lài) A
  這種情況下，Spring 容器在創(chuàng)建 A 時(shí)需要先創(chuàng)建 B，而創(chuàng)建 B 又需要先創(chuàng)建 A，陷入死循環(huán)。

二、依賴(lài)循環(huán)的典型場(chǎng)景（案例）

場(chǎng)景描述

假設(shè)我們正在開(kāi)發(fā)一個(gè)用戶(hù)服務(wù)系統(tǒng)，有兩個(gè)核心組件：

• UserService：負(fù)責(zé)用戶(hù)相關(guān)業(yè)務(wù)邏輯
• OrderService：負(fù)責(zé)訂單處理，其中需要驗(yàn)證用戶(hù)信息
  兩者相互調(diào)用對(duì)方的方法，導(dǎo)致循環(huán)依賴(lài)。

代碼示例

@Service
public class UserService {

    private final OrderService orderService;

    public UserService(OrderService orderService) {
        this.orderService = orderService;
    }

    public void handleUser() {
        System.out.println("Handling user...");
        orderService.checkOrders();
    }
}

@Service
public class OrderService {

    private final UserService userService;

    public OrderService(UserService userService) {
        this.userService = userService;
    }

    public void checkOrders() {
        System.out.println("Checking orders...");
        userService.handleUser(); // 實(shí)際中可能不是直接調(diào)用，但存在依賴(lài)關(guān)系
    }
}

啟動(dòng)報(bào)錯(cuò)

當(dāng)你啟動(dòng) Spring Boot 應(yīng)用時(shí)，會(huì)看到類(lèi)似如下錯(cuò)誤：

Error creating bean with name 'userService': Requested bean is currently in creation: Is there an unresolvable circular reference?

這是因?yàn)?Spring 默認(rèn)使用構(gòu)造器注入（Constructor Injection），而構(gòu)造器注入無(wú)法處理循環(huán)依賴(lài)（僅支持 setter 或 field 注入的三級(jí)緩存機(jī)制）。

三、為什么會(huì)出現(xiàn)依賴(lài)循環(huán)？

根本原因在于設(shè)計(jì)層面的耦合度過(guò)高。兩個(gè)本應(yīng)職責(zé)分離的服務(wù)，卻互相持有對(duì)方的引用，違反了“單一職責(zé)原則”和“依賴(lài)倒置原則”。

雖然 Spring 框架在某些情況下（如 setter 注入）可以通過(guò)三級(jí)緩存機(jī)制解決循環(huán)依賴(lài)，但構(gòu)造器注入 + 循環(huán)依賴(lài) = 必然失敗。

注意：Spring 僅支持單例 Bean 的 setter/field 注入下的循環(huán)依賴(lài)，不支持原型（Prototype）Bean 或構(gòu)造器注入的循環(huán)依賴(lài)。

四、解決方案詳解

方案一：重構(gòu)代碼，消除循環(huán)依賴(lài)（推薦）

這是最根本、最優(yōu)雅的解決方式。

思路：

• 提取公共邏輯到第三個(gè)服務(wù)
• 使用事件驅(qū)動(dòng)（ApplicationEvent）
• 通過(guò)接口解耦

示例：引入 UserValidator 服務(wù)

@Service
public class UserValidator {
    public boolean isValid(Long userId) {
        // 驗(yàn)證邏輯
        return true;
    }
}

@Service
public class UserService {
    private final UserValidator userValidator;

    public UserService(UserValidator userValidator) {
        this.userValidator = userValidator;
    }

    public void handleUser() {
        System.out.println("Handling user...");
    }
}

@Service
public class OrderService {
    private final UserValidator userValidator;

    public OrderService(UserValidator userValidator) {
        this.userValidator = userValidator;
    }

    public void checkOrders() {
        if (userValidator.isValid(1L)) {
            System.out.println("Orders are valid.");
        }
    }
}

優(yōu)點(diǎn)：職責(zé)清晰，無(wú)循環(huán)，易于測(cè)試和維護(hù)。

方案二：使用 @Lazy 延遲加載（快速修復(fù)）

在其中一個(gè)注入點(diǎn)上添加 @Lazy 注解，讓 Spring 在實(shí)際使用時(shí)才初始化該 Bean。

@Service
public class UserService {

    private final OrderService orderService;

    public UserService(@Lazy OrderService orderService) {
        this.orderService = orderService;
    }

    // ...
}

Spring 會(huì)在創(chuàng)建 UserService 時(shí)注入一個(gè)代理對(duì)象，真正調(diào)用方法時(shí)才初始化 OrderService。

注意：這只是“繞過(guò)”問(wèn)題，并未真正解決設(shè)計(jì)缺陷，僅適用于臨時(shí)修復(fù)。

方案三：改用 Setter 或 Field 注入（不推薦）

將構(gòu)造器注入改為 @Autowired 字段注入：

@Service
public class UserService {

    @Autowired
    private OrderService orderService;

    // ...
}

Spring 利用三級(jí)緩存（singletonObjects、earlySingletonObjects、singletonFactories）可以在這種情況下完成注入。

缺點(diǎn)：

• 破壞了不可變性
• 不利于單元測(cè)試
• 違背 Spring 官方推薦的“優(yōu)先使用構(gòu)造器注入”原則

官方文檔明確建議：盡可能使用構(gòu)造器注入，因?yàn)樗鼙ＷC依賴(lài)不為 null，且對(duì)象狀態(tài)完整。

方案四：使用 ApplicationContext 手動(dòng)獲取 Bean（極端情況）

@Component
public class ServiceLocator implements ApplicationContextAware {

    private static ApplicationContext context;

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) {
        ServiceLocator.context = applicationContext;
    }

    public static <T> T getBean(Class<T> clazz) {
        return context.getBean(clazz);
    }
}

// 在 UserService 中
public void someMethod() {
    OrderService orderService = ServiceLocator.getBean(OrderService.class);
    orderService.doSomething();
}

此方法破壞了 IoC 原則，應(yīng)盡量避免。

五、總結(jié)

最佳實(shí)踐建議：

• 優(yōu)先使用構(gòu)造器注入
• 避免服務(wù)之間直接相互依賴(lài)
• 通過(guò)領(lǐng)域事件、消息隊(duì)列或中介服務(wù)解耦
• 定期審查 Bean 依賴(lài)圖（可使用 spring-boot-starter-actuator 的 /beans 端點(diǎn)）

六、結(jié)語(yǔ)

依賴(lài)循環(huán)是 Spring 開(kāi)發(fā)中的常見(jiàn)陷阱，但它也是一面鏡子，反映出我們代碼設(shè)計(jì)中的耦合問(wèn)題。與其尋找“繞過(guò)”的技巧，不如借此機(jī)會(huì)優(yōu)化架構(gòu)，寫(xiě)出更清晰、更健壯的代碼。

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

最新評(píng)論