深度解析SpringBoot循环依赖问题与解决

 更新时间:2025年06月11日 08:04:42   作者:码农阿豪@新空间  
在Spring Boot开发过程中,循环依赖(Circular Dependency)是一个常见但棘手的问题,本文将通过两个典型案例,深入分析循环依赖问题的根源,并提供多种解决方案,希望对大家有所帮助

引言

在Spring Boot开发过程中,循环依赖(Circular Dependency)是一个常见但棘手的问题。当两个或多个Bean相互依赖时,Spring容器无法确定初始化顺序,导致应用启动失败。本文将通过两个典型案例,深入分析循环依赖问题的根源,并提供多种解决方案,帮助开发者彻底理解和解决这类问题。

1. 什么是循环依赖

循环依赖是指两个或多个Bean相互引用,形成闭环依赖关系。例如:

  • BeanA 依赖 BeanB
  • BeanB 依赖 BeanC
  • BeanC 又依赖 BeanA

Spring默认禁止循环依赖,因为它可能导致不可预测的行为,如NPE(NullPointerException)或初始化顺序问题。

2. 案例一:Shiro与Service层的循环依赖

问题分析

错误日志如下:

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

这是一个典型的服务层与Shiro安全框架的循环依赖问题:

  • ShiroFilter 依赖 SecurityManager
  • SecurityManager 依赖 UserRealm
  • UserRealm 依赖 SysUserService
  • SysUserService 依赖 SysRoleService
  • SysRoleService 又依赖 SysUserService,形成闭环。

解决方案

(1) 重构代码,消除循环依赖(推荐)

// 将 SysUserService 和 SysRoleService 的相互依赖改为单向依赖
@Service
public class SysUserServiceImpl implements SysUserService {
    // 不再直接依赖 SysRoleService
    // 改为通过方法参数传入
    public void someMethod(SysRoleService roleService) {
        // ...
    }
}

(2) 使用 @Lazy 延迟加载

@Service
public class SysUserServiceImpl implements SysUserService {
    @Lazy  // 延迟注入,避免循环依赖
    @Autowired
    private SysRoleService sysRoleService;
}

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

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

    @Autowired  // 使用Setter注入,Spring会在Bean初始化后再注入依赖
    public void setSysRoleService(SysRoleService sysRoleService) {
        this.sysRoleService = sysRoleService;
    }
}

(4) 临时启用循环引用(不推荐)

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

3. 案例二:PageHelper自动配置循环依赖

问题分析

错误日志:

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

这个问题通常是由于 PageHelper 版本与 Spring Boot 不兼容,或者自动配置类自身存在循环引用。

解决方案

(1) 升级 PageHelper 版本

<!-- pom.xml -->
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.4.6</version> <!-- 推荐使用最新稳定版 -->
</dependency>

(2) 排除自动配置

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

(3) 手动配置 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

确保没有引入多个不同版本的PageHelper。

4. 循环依赖的通用解决策略

方案适用场景优点缺点
重构代码长期项目彻底解决问题可能需要较大改动
@Lazy简单循环依赖改动小可能隐藏设计问题
Setter注入需要控制初始化顺序符合Spring推荐方式代码稍显冗长
允许循环引用紧急修复快速解决不推荐长期使用

5. 最佳实践与总结

最佳实践

避免双向依赖:尽量采用单向依赖,如 A → B,而不是 A ↔ B。

使用接口分离:将公共逻辑提取到单独接口,减少耦合。

优先使用构造器注入:

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

定期检查依赖冲突:使用 mvn dependency:tree 或 gradle dependencies。

总结

循环依赖问题虽然常见,但通过合理的架构设计、依赖管理和Spring提供的机制(如@Lazy、Setter注入),可以有效解决。长期来看,重构代码、优化设计是最佳方案,而临时方案(如allow-circular-references)仅适用于紧急修复。

到此这篇关于深度解析SpringBoot循环依赖问题与解决的文章就介绍到这了,更多相关SpringBoot循环依赖内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 使用springBoot中的info等级通过druid打印sql

    使用springBoot中的info等级通过druid打印sql

    这篇文章主要介绍了使用springBoot中的info等级通过druid打印sql,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-09-09
  • RestTemplate请求失败自动重启机制精讲

    RestTemplate请求失败自动重启机制精讲

    这篇文章主要为大家介绍了RestTemplate请求失败自定义处理的方法,自动重试的机制精讲,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多所进步,早日升职加薪
    2022-03-03
  • Mybatis反向工程出现BigDecimal类型问题及解决

    Mybatis反向工程出现BigDecimal类型问题及解决

    这篇文章主要介绍了Mybatis反向工程出现BigDecimal类型问题及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-09-09
  • Java实现选择排序

    Java实现选择排序

    这篇文章主要介绍了Java实现选择排序,把一列数组按从小到大或从大到小排序,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • 使用spring注入枚举类型作为参数

    使用spring注入枚举类型作为参数

    这篇文章主要介绍了使用spring注入枚举类型作为参数,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-09-09
  • IDEA操作MongoDB及安全认证方式

    IDEA操作MongoDB及安全认证方式

    这篇文章主要介绍了IDEA操作MongoDB及安全认证方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06
  • 聊聊Java三种常见的分布式锁

    聊聊Java三种常见的分布式锁

    目前分布式锁的实现方案主要包括三种,本文就来介绍一下这三种常见的分布式锁以及这三种锁的性能等,具有一定的参考价值,感兴趣的可以了解一下
    2023-06-06
  • SpringMVC实现Controller的三种方式总结

    SpringMVC实现Controller的三种方式总结

    这篇文章主要介绍了SpringMVC实现Controller的三种方式总结,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-02-02
  • SpringBoot实现字段自动填充的两种方式

    SpringBoot实现字段自动填充的两种方式

    每个字段在插入数据库,或者更新时都要在serviceimpl层对creatby,updateby等字段进行填充,这个太繁琐了,所以本文给大家介绍了SpringBoot实现字段自动填充的两种方式,需要的朋友可以参考下
    2024-11-11
  • Java实现中英文词典功能

    Java实现中英文词典功能

    这篇文章主要为大家详细介绍了Java实现中英文词典功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-09-09

最新评论