Spring Boot循环依赖原理、解决方案与最佳实践(全解析)

 更新时间:2025年04月17日 11:24:22   作者:weixin_52318532  
循环依赖指两个或多个Bean相互直接或间接引用,形成闭环依赖关系,这篇文章主要介绍了Spring Boot循环依赖原理、解决方案与最佳实践(全解析),需要的朋友可以参考下

🚨 Spring Boot循环依赖全解析:原理、解决方案与最佳实践

#SpringBoot核心 #依赖注入 #设计模式 #性能优化

一、循环依赖的本质与危害

1.1 什么是循环依赖?

循环依赖指两个或多个Bean相互直接或间接引用,形成闭环依赖关系。
典型场景

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

Spring启动时抛出异常:

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

1.2 核心危害

  • 应用启动失败:Spring无法完成Bean初始化
  • 设计缺陷信号:模块职责不清,耦合度过高
  • 潜在性能问题:即使解决循环依赖,可能引发隐藏的初始化顺序问题

pring无法完成Bean初始化设计缺陷信号:模块职责不清,耦合度过高潜在性能问题:即使解决循环依赖,可能引发隐藏的初始化顺序问题

二、Spring的三级缓存机制

Spring通过三级缓存解决Setter/Field注入的循环依赖,但无法解决构造器注入的循环依赖。

2.1 三级缓存结构

缓存级别存储内容
一级缓存(singletonObjects)完全初始化的Bean
二级缓存(earlySingletonObjects)提前暴露的早期Bean(未完成属性填充)
三级缓存(singletonFactories)Bean工厂对象(用于生成早期引用)

 2.2 解决流程(以ServiceA和ServiceB为例)

1. 创建ServiceA → 将原始对象工厂放入三级缓存  
2. 填充ServiceA属性 → 发现需要ServiceB  
3. 创建ServiceB → 将原始对象工厂放入三级缓存  
4. 填充ServiceB属性 → 从三级缓存获取ServiceA的工厂 → 生成代理对象  
5. ServiceB初始化完成 → 移入一级缓存  
6. ServiceA继续填充ServiceB → 从一级缓存获取ServiceB → 完成初始化  

三、解决方案与代码实战

3.1 避免构造器注入循环

构造器注入循环依赖无法解决(Spring 5.3+默认禁止):

// 错误示例:启动直接失败  
@Service  
public class ServiceA {  
    private final ServiceB serviceB;  
    public ServiceA(ServiceB serviceB) {  
        this.serviceB = serviceB;  
    }  
}  
@Service  
public class ServiceB {  
    private final ServiceA serviceA;  
    public ServiceB(ServiceA serviceA) {  
        this.serviceA = serviceA;  
    }  
}  

强制允许构造器循环依赖(不推荐)

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

3.2 使用Setter/Field注入

将构造器注入改为Setter注入:

@Service  
public class ServiceA {  
    private ServiceB serviceB;  
    @Autowired  
    public void setServiceB(ServiceB serviceB) {  
        this.serviceB = serviceB;  
    }  
}  
@Service  
public class ServiceB {  
    private ServiceA serviceA;  
    @Autowired  
    public void setServiceA(ServiceA serviceA) {  
        this.serviceA = serviceA;  
    }  
}  

3.3 @Lazy延迟加载

强制延迟其中一个Bean的初始化:

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

原理:ServiceB被代理,首次调用时才会真实初始化。

3.4 接口抽象解耦

通过接口隔离实现类依赖

public interface IServiceA {  
    void doSomething();  
}  
public interface IServiceB {  
    void doAnother();  
}  
@Service  
public class ServiceAImpl implements IServiceA {  
    @Autowired  
    private IServiceB serviceB;  
}  
@Service  
public class ServiceBImpl implements IServiceB {  
    @Autowired  
    private IServiceA serviceA;  
}  

四、深度优化:设计模式应用

4.1 依赖倒置原则(DIP)

高层模块不应依赖低层模块,二者都应依赖抽象

// 定义数据访问接口  
public interface UserRepository {  
    User findById(Long id);  
}  
// 高层服务依赖接口  
@Service  
public class UserService {  
    private final UserRepository repository;  
    public UserService(UserRepository repository) {  
        this.repository = repository;  
    }  
}  
// 低层实现  
@Repository  
public class JpaUserRepository implements UserRepository {  
    // 实现细节  
}  

4.2 事件驱动模型

通过ApplicationEvent解耦强依赖

// ServiceA发布事件  
@Service  
public class ServiceA {  
    @Autowired  
    private ApplicationEventPublisher publisher;  
    public void triggerEvent() {  
        publisher.publishEvent(new CustomEvent(this));  
    }  
}  
// ServiceB监听事件  
@Service  
public class ServiceB {  
    @EventListener  
    public void handleEvent(CustomEvent event) {  
        // 处理逻辑  
    }  
}  

五、检测与预防工具

5.1 IDE检测

  • IntelliJ IDEA:自动标记循环依赖(需安装Spring Assistant插件)
  • Eclipse:通过STS (Spring Tool Suite)插件提示

5.2 Maven插件分析

<plugin>  
    <groupId>org.springframework.boot</groupId>  
    <artifactId>spring-boot-maven-plugin</artifactId>  
    <configuration>  
        <excludes>  
            <exclude>  
                <groupId>org.projectlombok</groupId>  
                <artifactId>lombok</artifactId>  
            </exclude>  
        </excludes>  
    </configuration>  
</plugin>  

运行命令:

mvn spring-boot:run -Dspring-boot.run.profiles=dev  

5.3 架构规范

  • 模块化设计:按业务拆分模块(如user-serviceorder-service
  • 依赖规则
    • 下层模块可依赖上层
    • 同层禁止相互依赖
    • 通用工具类下沉至common模块

六、常见问题解答

Q1:允许循环依赖对性能有影响吗?

  • 短期影响:增加Bean创建时的上下文切换
  • 长期风险:可能导致内存泄漏(如未正确释放代理对象)

Q2:@Lazy注解可以随便用吗?

  • 慎用场景:频繁调用的Bean会增加代理开销
  • 最佳实践:仅用于解决无法重构的历史代码

Q3:Spring为什么能解决Setter注入循环依赖?

  • 核心机制:三级缓存提前暴露未完成初始化的对象引用

七、总结与最佳实践

黄金法则

  • 优先使用构造器注入:强制暴露依赖关系
  • 遵守单一职责原则:拆分超过500行代码的类
  • 定期依赖审查:使用ArchUnit等工具检测架构规范

紧急修复流程

发现循环依赖 → 使用@Lazy临时解决 → 标记为技术债务 → 排期重构  

工具推荐

通过合理设计+规范约束,可有效避免循环依赖,构建高可维护的Spring Boot应用! 🚀

到此这篇关于Spring Boot循环依赖全解析:原理、解决方案与最佳实践的文章就介绍到这了,更多相关Spring Boot循环依赖内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot中的@EnableAutoConfiguration注解解析

    SpringBoot中的@EnableAutoConfiguration注解解析

    这篇文章主要介绍了SpringBoot中的@EnableAutoConfiguration注解解析,@EnableAutoConfiguration也是借助@Import的帮助,将所有符合自动配置条件的bean定义注册到IoC容器,需要的朋友可以参考下
    2023-09-09
  • 如何将maven项目划分为多个模块

    如何将maven项目划分为多个模块

    这篇文章主要介绍了如何将maven项目划分为多个模块,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-09-09
  • Spring框架对于Bean的管理详解

    Spring框架对于Bean的管理详解

    在实际开发中,我们往往要用到Spring容器为我们提供的诸多资源,例如想要获取到容器中的配置、获取到容器中的Bean等等。本文为大家详细讲讲工具类如何获取到Spring容器中的Bean,需要的可以参考一下
    2022-07-07
  • Spring5新特性之Reactive响应式编程

    Spring5新特性之Reactive响应式编程

    这篇文章主要介绍了Spring5新特性之Reactive响应式编程,响应式编程是一种编程范式,通用和专注于数据流和变化的,并且是异步的,下文更多详细内容,需要的小伙伴可以参考一下,希望对你有所帮助
    2022-03-03
  • JAVA读取二进制文件以及画图教程

    JAVA读取二进制文件以及画图教程

    由于项目需要,需要对二进制文件进行读取,所以这篇文章主要给大家介绍了关于JAVA读取二进制文件以及画图的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2023-07-07
  • Springboot Redis设置key前缀的方法步骤

    Springboot Redis设置key前缀的方法步骤

    这篇文章主要介绍了Springboot Redis设置key前缀的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • Java如何获取相对路径文件

    Java如何获取相对路径文件

    这篇文章主要介绍了Java如何获取相对路径文件问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-06-06
  • java爬取并下载酷狗TOP500歌曲的方法

    java爬取并下载酷狗TOP500歌曲的方法

    这篇文章主要介绍了java爬取并下载酷狗TOP500歌曲的方法,非常具有实用价值,需要的朋友可以参考下
    2019-01-01
  • 关于idea中ssm框架的编码问题分析

    关于idea中ssm框架的编码问题分析

    在实际开发中需要将操作系统编码、文件编码、页面编码以及tomcat服务器编码保持一致,而tomcat在默认情况下是使用UTF-8,这就使得其打印的日志文件出现中文乱码,因此在一般情况下,只需要将tomcat服务器的编码改为GBK即可
    2021-06-06
  • Java访问者设计模式详细讲解

    Java访问者设计模式详细讲解

    大多数情况下你不需要访问者模式,但当一旦需要访问者模式时,那就是真的需要它了,这是设计模式创始人的原话。可以看出应用场景比较少,但需要它的时候是不可或缺的,这篇文章就开始学习最后一个设计模式——访问者模式
    2022-11-11

最新评论