1. 项目概述上周在重构一个老项目时我遇到了一个典型的Spring循环依赖问题。表面上看只是常见的BeanCurrentlyInCreationException但实际排查过程却意外地复杂。这个案例涉及Async注解、自定义AgentService和Spring三级缓存的交互最终花了整整两天时间才彻底解决。今天我就把这个排查过程完整记录下来希望能帮到遇到类似问题的同行。2. 问题现象与初步分析2.1 异常堆栈解读系统启动时抛出的异常堆栈如下org.springframework.beans.factory.BeanCurrentlyInCreationException: Error creating bean with name orderService: Bean with name orderService has been injected into other beans [...] in its raw version as part of a circular reference这个异常表明Spring在创建orderService时检测到了循环依赖。但奇怪的是这个服务在项目中已经稳定运行了两年最近只是添加了几个Async方法就突然出现了这个问题。2.2 依赖关系图谱通过IDE的依赖分析工具我绘制出了关键的依赖关系orderService → paymentService → notificationService → asyncExecutor → orderService这个环形依赖链中asyncExecutor是Spring的异步任务执行器notificationService通过Async注解依赖它而最终又绕回了orderService。3. 循环依赖的深层原理3.1 Spring三级缓存机制Spring解决循环依赖的核心在于三级缓存一级缓存存放完整初始化后的单例Bean二级缓存存放早期暴露的Bean引用已实例化但未初始化三级缓存存放Bean工厂对象用于处理代理等情况当出现循环依赖时Spring会通过提前暴露对象引用的方式打破循环。但某些特殊情况会破坏这个机制。3.2 Async的特殊处理Async注解会为方法创建AOP代理这个代理的创建时机很关键普通Bean在初始化完成后创建代理循环依赖中的Bean必须在早期暴露阶段就创建代理如果代理创建时机不对就会导致依赖注入的对象版本不一致。4. 问题排查过程4.1 代理对象验证通过在构造器中打印this.getClass()我发现// OrderService构造器输出 class com.example.OrderService$$EnhancerBySpringCGLIB$$12345678 // PaymentService中注入的orderService类型 class com.example.OrderService这表明注入的实例和实际实例不是同一个代理对象验证了代理创建时机的问题。4.2 解决方案对比我尝试了三种解决方案使用Lazy注解Service public class PaymentService { Lazy Autowired private OrderService orderService; }优点快速解决启动问题缺点只是延迟了问题发生时间可能引发运行时异常调整Bean加载顺序DependsOn({paymentService, notificationService}) Service public class OrderService {...}结果无效因为循环依赖的本质未改变重构代码结构最终方案将Async方法提取到独立的AsyncNotificationService使用事件驱动模型解耦服务5. 最佳实践建议5.1 循环依赖设计原则优先考虑重构代码结构避免循环依赖必须循环时确保是setter注入而非构造器注入避免在循环依赖链中使用AOP代理5.2 Async使用注意事项异步方法最好放在专门的Service中避免在循环依赖的Bean上使用Async考虑使用ApplicationEvent实现异步通知6. 扩展思考Spring代理机制6.1 JDK动态代理 vs CGLIB在解决这个问题时我注意到Spring会根据类是否实现接口选择代理方式实现接口JDK动态代理未实现接口CGLIB可以通过配置强制使用CGLIBspring.aop.proxy-target-classtrue6.2 代理对象的识别技巧在调试时可以通过这些方法识别代理对象打印对象的class名称包含$$EnhancerBySpringCGLIB$$使用AopUtils工具类AopUtils.isAopProxy(bean) AopUtils.isCglibProxy(bean)7. 性能优化建议7.1 异步线程池配置默认的SimpleAsyncTaskExecutor不适合生产环境建议配置Configuration EnableAsync public class AsyncConfig implements AsyncConfigurer { Override public Executor getAsyncExecutor() { ThreadPoolTaskExecutor executor new ThreadPoolTaskExecutor(); executor.setCorePoolSize(5); executor.setMaxPoolSize(10); executor.setQueueCapacity(100); executor.setThreadNamePrefix(Async-Executor-); executor.initialize(); return executor; } }7.2 循环依赖监控添加健康检查端点监控循环依赖management.endpoint.health.show-detailsalways management.health.circuitbreakers.enabledtrue8. 常见问题排查指南8.1 典型错误场景构造器注入循环依赖Service public class A { private final B b; public A(B b) { this.b b; } } Service public class B { private final A a; public B(A a) { this.a a; } }解决方案改为setter注入Async方法调用内部方法public void methodA() { methodB(); // 不会走代理 } Async public void methodB() {...}解决方案通过AopContext获取代理对象8.2 调试技巧启用Spring调试日志logging.level.org.springframework.beansDEBUG logging.level.org.springframework.contextDEBUG使用BeanPostProcessor打印Bean生命周期Component public class MyBeanPostProcessor implements BeanPostProcessor { Override public Object postProcessBeforeInitialization(Object bean, String beanName) { System.out.println(Before init: beanName); return bean; } }9. 高级应用场景9.1 自定义AgentService实现在某些特殊场景下可能需要自定义服务代理public interface AgentServiceT { T getAgent(); } Service public class OrderAgentService implements AgentServiceOrderService { Lazy Autowired private OrderService orderService; Override public OrderService getAgent() { return orderService; } }9.2 结合Spring Cloud的使用在微服务架构中循环依赖可能跨越服务边界。这时可以考虑使用Feign客户端熔断器引入消息队列解耦采用Saga模式管理分布式事务10. 源码级分析10.1 DefaultSingletonBeanRegistry解析Spring处理循环依赖的核心类// 三级缓存定义 private final MapString, Object singletonObjects new ConcurrentHashMap(256); // 一级缓存 private final MapString, Object earlySingletonObjects new HashMap(16); // 二级缓存 private final MapString, ObjectFactory? singletonFactories new HashMap(16); // 三级缓存 protected Object getSingleton(String beanName, boolean allowEarlyReference) { // 检查一级缓存 Object singletonObject this.singletonObjects.get(beanName); if (singletonObject null isSingletonCurrentlyInCreation(beanName)) { // 检查二级缓存 singletonObject this.earlySingletonObjects.get(beanName); if (singletonObject null allowEarlyReference) { // 检查三级缓存 ObjectFactory? singletonFactory this.singletonFactories.get(beanName); if (singletonFactory ! null) { singletonObject singletonFactory.getObject(); this.earlySingletonObjects.put(beanName, singletonObject); this.singletonFactories.remove(beanName); } } } return singletonObject; }10.2 AbstractAutowireCapableBeanFactory关键方法Bean实例化的核心流程protected Object doCreateBean(String beanName, RootBeanDefinition mbd, Nullable Object[] args) { // 1. 实例化 BeanWrapper instanceWrapper createBeanInstance(beanName, mbd, args); // 2. 添加到三级缓存解决循环依赖关键步骤 addSingletonFactory(beanName, () - getEarlyBeanReference(beanName, mbd, bean)); // 3. 属性注入 populateBean(beanName, mbd, instanceWrapper); // 4. 初始化 exposedObject initializeBean(beanName, exposedObject, mbd); return exposedObject; }11. 性能优化深度实践11.1 循环依赖对启动时间的影响通过JProfiler测试发现每个循环依赖会增加约50-100ms的启动时间深度循环依赖A→B→C→A比直接循环A↔B影响更大优化建议使用DependsOn明确依赖关系将非必要依赖改为懒加载拆分大型配置类11.2 内存占用分析循环依赖会导致更长的对象保留在创建中状态三级缓存占用额外内存可能的内存泄漏风险如果循环依赖中包含大对象检测方法// 在BeanPostProcessor中记录创建中的Bean SetString creatingBeans Collections.newSetFromMap(new ConcurrentHashMap()); Override public Object postProcessBeforeInitialization(Object bean, String beanName) { creatingBeans.add(beanName); return bean; } Override public Object postProcessAfterInitialization(Object bean, String beanName) { creatingBeans.remove(beanName); return bean; }12. 替代方案探讨12.1 使用事件驱动模型重构后的通知流程// 事件定义 public class OrderCompletedEvent { private Order order; // getters/setters } // 发布事件 Service public class OrderService { Autowired ApplicationEventPublisher eventPublisher; public void completeOrder(Order order) { // 业务逻辑 eventPublisher.publishEvent(new OrderCompletedEvent(order)); } } // 异步处理 Service public class NotificationService { Async EventListener public void handleOrderCompleted(OrderCompletedEvent event) { // 发送通知 } }12.2 采用响应式编程使用Spring WebFlux重构Service public class ReactiveOrderService { private final ReactivePaymentService paymentService; public MonoOrder createOrder(Order order) { return paymentService.validatePayment(order) .then(notificationService.sendNotification(order)) .thenReturn(order); } }13. 生产环境经验总结13.1 监控指标设置建议监控这些关键指标Bean创建时间特别是循环依赖中的Bean代理对象创建数量异步任务队列积压情况配置示例management.metrics.enable.spring.beanstrue management.metrics.enable.spring.aoptrue13.2 压力测试要点测试循环依赖系统时需要关注高并发下的死锁风险内存泄漏迹象代理对象创建的性能开销测试方案SpringBootTest ActiveProfiles(test) public class CircularDependencyStressTest { Autowired ApplicationContext context; Test void testConcurrentAccess() { IntStream.range(0, 1000).parallel().forEach(i - { OrderService service context.getBean(OrderService.class); assertNotNull(service); }); } }14. 工具链推荐14.1 分析工具Spring Boot Actuator/beans端点查看Bean依赖关系/health端点检查循环断路器状态VisualVM分析Bean实例的内存占用跟踪代理对象的创建过程14.2 开发辅助IDE插件IntelliJ IDEA的Spring AssistantEclipse的Spring Tools Suite代码检查工具SonarQube的Spring规则集ArchUnit测试架构约束15. 未来演进方向随着Spring框架的发展循环依赖处理也在不断优化Spring Boot 3.0对启动流程的改进GraalVM原生镜像对循环依赖的限制响应式编程对传统依赖模式的改变对于新项目建议优先考虑响应式编程模型采用模块化设计减少耦合利用Spring Boot的自动配置优化这个案例给我的深刻教训是看似简单的循环依赖问题在结合了Async等高级特性后会变得异常复杂。关键在于理解Spring容器的工作原理并合理设计应用架构。当遇到类似问题时建议从代理机制、缓存层级和Bean生命周期三个维度综合分析。
)
