Spring Boot循环依赖问题深度解析与解决方案

个人名片

🎓作者简介：java领域优质创作者
🌐个人主页：码农阿豪
📞工作室：新空间代码工作室（提供各种软件服务)
💌个人邮箱：[2435024119@qq.com]
📱个人微信：15279484656
🌐个人导航网站：www.forff.top
💡座右铭：总有人要赢。为什么不能是我呢？

• 专栏导航：

码农阿豪系列专栏导航
面试专栏：收集了java相关高频面试题，面试实战总结🍻🎉🖥️
Spring5系列专栏：整理了Spring5重要知识点与实战演练，有案例可直接使用🚀🔧💻
Redis专栏：Redis从零到一学习分享，经验总结，案例实战💐📝💡
全栈系列专栏：海纳百川有容乃大，可能你想要的东西里面都有🤸🌱🚀

目录

• Spring Boot循环依赖问题深度解析与解决方案
• • 引言
  • 目录
  • 1. 什么是循环依赖？
  • 2. 案例一：Shiro与Service层的循环依赖
  • • 问题分析
    • 解决方案
    • • (1) 重构代码，消除循环依赖（推荐）
      • (2) 使用 `@Lazy` 延迟加载
      • (3) 使用 Setter 注入替代字段注入
      • (4) 临时启用循环引用（不推荐）
  • 3. 案例二：PageHelper自动配置循环依赖
  • • 问题分析
    • 解决方案
    • • (1) 升级 PageHelper 版本
      • (2) 排除自动配置
      • (3) 手动配置 PageHelper
      • (4) 检查依赖冲突
  • 4. 循环依赖的通用解决策略
  • 5. 最佳实践与总结
  • • 最佳实践
    • 总结

Spring Boot循环依赖问题深度解析与解决方案

引言

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

---

目录

1. 什么是循环依赖？
2. 案例一：Shiro与Service层的循环依赖
   • 问题分析
   • 解决方案
3. 案例二：PageHelper自动配置循环依赖
   • 问题分析
   • 解决方案
4. 循环依赖的通用解决策略
5. 最佳实践与总结

---

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安全框架的循环依赖问题：

1. ShiroFilter 依赖 SecurityManager
2. SecurityManager 依赖 UserRealm
3. UserRealm 依赖 SysUserService
4. SysUserService 依赖 SysRoleService
5. 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. 最佳实践与总结

最佳实践

1. 避免双向依赖：尽量采用单向依赖，如 A → B，而不是 A ↔ B。
2. 使用接口分离：将公共逻辑提取到单独接口，减少耦合。
3. 优先使用构造器注入：

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

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

总结

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

希望本文能帮助你彻底理解并解决Spring Boot中的循环依赖问题！ 🚀