☰

企业官网建设流程全解析

首页 / 建站日记 / 企业官网建设流程全解析
Spring AOP循环依赖问题解析与解决方案
2026/9/11 21:20:25 网站建设 项目流程

1. Spring AOP循环依赖问题解析

在Spring框架的实际开发中，循环依赖和AOP代理是两个经常遇到的"头疼"问题。当它们同时出现时，情况会变得更加复杂。最近在重构一个权限校验系统时，我就遇到了典型的AOP循环依赖场景：ServiceA依赖ServiceB，ServiceB又依赖ServiceA，同时这两个Service都需要被AOP代理进行权限控制。

重要提示：Spring默认支持解决普通bean的循环依赖（通过三级缓存机制），但当AOP介入后，情况会变得特殊。这是因为AOP代理对象的创建时机与普通bean不同。

1.1 循环依赖的本质

循环依赖本质上是一个对象图构建问题。假设有以下依赖链：

  • ClassA → ClassB → ClassA

Spring容器在初始化时，会按以下步骤尝试构建这个依赖链：

  1. 开始创建ClassA实例
  2. 发现ClassA依赖ClassB
  3. 暂停ClassA的创建，转去创建ClassB
  4. 发现ClassB又依赖ClassA
  5. 此时就形成了循环依赖

1.2 AOP如何影响循环依赖

当AOP介入后，问题变得更加复杂。因为Spring AOP是通过动态代理实现的，代理对象的创建时机很关键：

  1. 如果是JDK动态代理：在bean初始化完成后才创建代理
  2. 如果是CGLIB代理：在bean实例化后就会创建代理

这种差异会导致在循环依赖场景下，获取到的可能是原始对象而非代理对象，进而引发各种奇怪的问题。

2. Spring的三级缓存机制

Spring通过三级缓存来解决循环依赖问题，理解这个机制是解决问题的关键。

2.1 三级缓存详解

Spring容器内部维护了三个重要的缓存：

缓存级别名称存储内容作用时期
一级缓存singletonObjects完全初始化好的bean任何时候
二级缓存earlySingletonObjects提前暴露的原始bean（未完成初始化）解决循环依赖时
三级缓存singletonFactoriesObjectFactory工厂对象创建bean的早期阶段

2.2 AOP与三级缓存的交互

当AOP介入时，Spring的处理流程会发生变化：

  1. 创建原始bean实例
  2. 将创建代理的ObjectFactory放入三级缓存
  3. 如果出现循环依赖，会通过ObjectFactory提前获取代理对象
  4. 最终将完全初始化好的代理对象放入一级缓存

这个流程保证了即使在循环依赖场景下，也能正确获取到代理对象。

3. 解决AOP循环依赖的实践方案

基于项目经验，我总结了以下几种可行的解决方案。

3.1 方案一：使用@Lazy注解

这是最简单的解决方案，通过在依赖注入点添加@Lazy注解，延迟依赖的解析：

@Service public class ServiceA { @Autowired @Lazy // 关键注解 private ServiceB serviceB; }

原理分析：

  • @Lazy会创建一个代理对象注入
  • 实际调用时才会真正解析依赖
  • 打破了初始化时的循环依赖链

优点：实现简单，代码侵入小 缺点：可能隐藏设计问题，过度使用会导致调试困难

3.2 方案二：调整依赖关系

这是最根本的解决方案，通过重构代码消除循环依赖：

  1. 提取公共逻辑到第三个服务中
  2. 使用事件驱动模型解耦
  3. 应用接口隔离原则

重构示例：

// 将公共逻辑提取到新服务 @Service public class CommonService { // 原ServiceA和ServiceB的公共方法 } @Service public class ServiceA { @Autowired private CommonService commonService; } @Service public class ServiceB { @Autowired private CommonService commonService; }

3.3 方案三：使用Setter注入

通过Setter方法注入可以改变bean的创建顺序：

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

原理：

  • Setter注入发生在对象实例化之后
  • 允许先创建不完整的bean实例
  • 更适合循环依赖场景

3.4 方案四：调整AOP代理方式

Spring Boot 2.x后默认使用CGLIB代理，可以通过配置改为JDK动态代理：

# application.properties spring.aop.proxy-target-class=false

不同代理方式的循环依赖处理差异：

代理方式代理创建时机循环依赖支持
JDK动态代理初始化完成后较差
CGLIB实例化后，初始化前较好

4. 典型问题排查与解决

在实际项目中，我遇到过以下几种典型问题场景。

4.1 问题一：AOP拦截失效

症状：

  • 明明配置了AOP拦截
  • 但方法调用时没有触发切面逻辑

原因分析：

  • 获取到的是原始对象而非代理对象
  • 常见于循环依赖场景下的自调用

解决方案：

  1. 检查是否使用了this.method()调用（应改为注入自身代理）
  2. 使用AopContext获取当前代理：
@Service public class SomeService { public void methodA() { ((SomeService)AopContext.currentProxy()).methodB(); } public void methodB() { // ... } }

4.2 问题二：启动时报循环依赖错误

错误信息示例：

The dependencies of some of the beans in the application context form a cycle

解决方案步骤：

  1. 分析Spring打印的依赖环
  2. 优先考虑使用@Lazy打破循环
  3. 重构设计消除循环依赖
  4. 如果必须保留循环依赖，可以设置允许：
# application.properties spring.main.allow-circular-references=true

4.3 问题三：事务注解失效

特殊场景：

  • 循环依赖中的事务方法不生效
  • 事务回滚不符合预期

根本原因：

  • 事务也是基于AOP实现的
  • 循环依赖可能导致事务代理创建异常

解决方案：

  1. 确保使用代理对象调用事务方法
  2. 避免在构造函数中调用事务方法
  3. 检查@Transactional注解的传播属性

5. 性能优化与最佳实践

在解决AOP循环依赖问题时，还需要考虑性能影响。

5.1 代理创建性能对比

实测数据（基于Spring Boot 2.7，10000次调用）：

代理方式初始化时间内存占用调用性能
JDK动态代理120ms较低较好
CGLIB350ms较高稍差

建议：

  • 无循环依赖场景：优先JDK动态代理
  • 有循环依赖场景：考虑CGLIB

5.2 循环依赖检测工具

推荐使用Spring Boot Actuator的beans端点分析依赖关系：

# application.properties management.endpoints.web.exposure.include=beans

访问/actuator/beans可以看到完整的依赖关系图。

5.3 设计模式建议

  1. 应用依赖倒置原则（DIP）
  2. 考虑使用观察者模式解耦
  3. 合理使用门面模式封装服务

示例代码：

// 使用门面模式封装循环依赖服务 @Service public class ServiceFacade { @Autowired private ServiceA serviceA; @Autowired private ServiceB serviceB; public void businessMethod() { // 协调调用serviceA和serviceB } }

6. 源码级深度解析

理解Spring源码实现有助于更好地解决问题。

6.1 AbstractAutowireCapableBeanFactory关键方法

Spring处理循环依赖的核心逻辑在doCreateBean方法中：

protected Object doCreateBean(/*...*/) { // 实例化bean instanceWrapper = createBeanInstance(beanName, mbd, args); // 提前暴露引用（解决循环依赖关键） if (earlySingletonExposure) { addSingletonFactory(beanName, () -> getEarlyBeanReference(beanName, mbd, bean)); } // 属性填充（可能触发循环依赖） populateBean(beanName, mbd, instanceWrapper); // 初始化 exposedObject = initializeBean(beanName, exposedObject, mbd); }

6.2 AOP代理创建流程

Spring AOP代理的创建在AbstractAutoProxyCreator中实现：

  1. postProcessAfterInitialization（JDK代理）
  2. wrapIfNecessary（CGLIB代理）
  3. 最终通过DefaultAopProxyFactory创建代理

6.3 循环依赖处理时序图

  1. 创建BeanA
  2. 将BeanA的ObjectFactory放入三级缓存
  3. 填充BeanA属性时发现需要BeanB
  4. 创建BeanB
  5. 填充BeanB属性时发现需要BeanA
  6. 从三级缓存获取BeanA的早期引用
  7. 完成BeanB的创建
  8. 完成BeanA的创建

7. 新版Spring的变化

Spring Framework 6.x和Spring Boot 3.x对循环依赖处理有改进。

7.1 新版本中的优化

  1. 更早的循环依赖检测
  2. 更清晰的错误信息
  3. 改进了AOP代理的处理逻辑

7.2 迁移注意事项

从Spring Boot 2.x升级到3.x时：

  1. 检查@Lazy注解的使用
  2. 测试循环依赖场景
  3. 可能需要调整代理方式配置
# Spring Boot 3.x中的新配置 spring.aop.proxy-target-class=true|false

7.3 未来发展趋势

  1. 可能引入更智能的循环依赖解决方案
  2. 对Reactive编程的更好支持
  3. 更细粒度的代理控制

在实际项目中，我发现理解Spring处理循环依赖和AOP的底层机制非常重要。这不仅帮助我解决了眼前的问题，还能在遇到类似情况时快速定位问题根源。特别是在微服务架构中，良好的服务设计可以避免大多数循环依赖问题。

标签： 网站建设 企业官网 项目流程 UI设计 前端开发

热门文章

文章分类

标签云

网站建设 响应式设计 用户体验 SEO优化 前端开发 小程序 电商平台 性能优化

相关文章

您可能感兴趣的其他内容

单北斗GNSS如何实现毫米级变形监测？从原理到实战部署全解析
2026/9/11 21:20:19 网站建设

单北斗GNSS如何实现毫米级变形监测？从原理到实战部署全解析

做变形监测这行时间长了，能明显感觉到设备采购风向的变化。前几年写技术方案，讲究的是“四星八频”，恨不得把接收机支持多少个卫星频点全写在第一页。到了这两年，越来越多的招标文件把“单北斗GNSS”单独拎出来，写成“…...

阅读更多 →
MLflow LightGBM 集成完全指南：模型日志、加载与自动记录（mlflow.lightgbm API 深度解析）
2026/9/11 21:18:28 网站建设

MLflow LightGBM 集成完全指南：模型日志、加载与自动记录（mlflow.lightgbm API 深度解析）

MLflow LightGBM 集成完全指南：模型日志、加载与自动记录（mlflow.lightgbm API 深度解析） 【免费下载链接】mlflow The open source AI engineering platform for agents, LLMs, and ML models. MLflow enables teams of all sizes to debug,…...

阅读更多 →
用 Language Server Protocol 为 Tabby 打造统一编辑器集成：tabby-agent 语言服务器实战指南
2026/9/11 21:17:35 网站建设

用 Language Server Protocol 为 Tabby 打造统一编辑器集成：tabby-agent 语言服务器实战指南

用 Language Server Protocol 为 Tabby 打造统一编辑器集成：tabby-agent 语言服务器实战指南 【免费下载链接】tabby Self-hosted AI coding assistant 项目地址: https://gitcode.com/GitHub_Trending/tab/tabby Tabby 是一个可自托管的 AI 编程助手&#x…...

阅读更多 →

需要专业的网站建设服务？

联系我们获取免费的网站建设咨询和方案报价，让我们帮助您实现业务目标

立即咨询