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增强Controller方法@ControllerAdvice注解的使用详解

    SpringBoot增强Controller方法@ControllerAdvice注解的使用详解

    这篇文章主要介绍了SpringBoot增强Controller方法@ControllerAdvice注解的使用详解,@ControllerAdvice,是Spring3.2提供的新注解,它是一个Controller增强器,可对controller进行增强处理,需要的朋友可以参考下
    2023-10-10
  • Java对象存储内存布局详解

    Java对象存储内存布局详解

    众所周知,Java是一门面向对象的语言,那么一个对象在内存中都包含什么东西呢,本文主要详细介绍了Java对象的内存布局,访问定位,创建过程,线程安全,感兴趣的小伙伴可以跟着小编一起来学习
    2023-04-04
  • 学生视角手把手带你写Java 线程池初版

    学生视角手把手带你写Java 线程池初版

    作者是一个来自河源的大三在校生,以下笔记都是作者自学之路的一些浅薄经验,如有错误请指正,将来会不断的完善笔记,帮助更多的Java爱好者入门
    2022-03-03
  • IDEA中Jar包的制作和使用方法

    IDEA中Jar包的制作和使用方法

    这篇文章主要介绍了IDEA的Jar包的制作和使用方法,文中补充介绍了idea的pom依赖配置后,不会自动下载jar包的解决办法,感兴趣的朋友跟随小编一起看看吧
    2025-04-04
  • java for循环内执行多线程问题

    java for循环内执行多线程问题

    这篇文章主要介绍了java for循环内执行多线程问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-03-03
  • 使用代码生成器自定义Entity的部分注解

    使用代码生成器自定义Entity的部分注解

    这篇文章主要介绍了使用代码生成器自定义Entity的部分注解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-05-05
  • java如何解析/读取xml文件

    java如何解析/读取xml文件

    这篇文章主要为大家详细介绍了java如何解析/读取xml文件的方法,感兴趣的小伙伴们可以参考一下
    2016-03-03
  • Java编程代码性能优化

    Java编程代码性能优化

    本文介绍了 Java 代码优化的过程,总结了优化 Java 程序的一些最佳实践,分析了进行优化的方法,并解释了性能提升的原因,需要的朋友可以参考下
    2015-11-11
  • Java分别利用深度优先和广度优先求解迷宫路径

    Java分别利用深度优先和广度优先求解迷宫路径

    这篇文章主要为大家详细介绍了Java如何利用深度优先的非递归遍历方法和广度优先的遍历方法实现求解迷宫路径,文中的示例代码讲解详细,需要的可以参考一下
    2022-08-08
  • Java实现将彩色PDF转为灰度PDF的示例代码

    Java实现将彩色PDF转为灰度PDF的示例代码

    本文以Java代码为例介绍如何实现将彩色PDF文件转为灰度(黑白)的PDF文件,文中的示例代码讲解详细,感兴趣的小伙伴快跟随小编一起学习一下吧
    2022-03-03

最新评论