三级缓存到底缓存了什么:一次 @Transactional 代理把循环依赖炸在启动阶段的复盘

发布时间:2026/11/16 9:21:17

三级缓存到底缓存了什么:一次 @Transactional 代理把循环依赖炸在启动阶段的复盘 title: 三级缓存到底缓存了什么一次 Transactional 代理把循环依赖炸在启动阶段的复盘tags: [Spring, 循环依赖, 三级缓存, 源码分析, Java]category: 后端一个周三早上订单服务起不来了我们组的订单服务在测试环境发布后启动失败控制台甩出这么一段org.springframework.beans.factory.BeanCurrentlyInCreationException: Error creating bean with name orderServiceImpl: Bean with name orderServiceImpl has been injected into other beans [couponServiceImpl] in its raw version as part of a circular reference, but has eventually been wrapped. This means that said other beans do not use the final version of the bean.关键词是最后半句其他 bean 拿到的不是最终版本的 bean。改动本身很小OrderServiceImpl上加了一个Transactional因为要把「扣库存 写订单」放进同一个事务。加之前一切正常加之后启动直接崩。当时组里第一反应是「Spring 不是能自动解决循环依赖吗」于是就有了这次把三级缓存从头翻了一遍的排查。Spring Boot 版本 2.3.12Spring Framework 5.2.15JDK 8。这个组合很关键后面会说为什么。先把现场还原出来去掉业务逻辑后最小复现代码是这样Service public class OrderServiceImpl implements OrderService { // 构造器之外的字段注入Spring 允许循环依赖 Autowired private CouponService couponService; Override Transactional(rollbackFor Exception.class) // 罪魁祸首在这一行 public void createOrder(Long userId, Long skuId) { couponService.deduct(userId); // ... 写订单 } } Service public class CouponServiceImpl implements CouponService { Autowired private OrderService orderService; // 反向依赖闭环形成 Override public void deduct(Long userId) { // ... 扣券 } }逐行看这段代码的要害第 5 行Autowired是字段注入。Spring 只对字段/setter 注入的循环依赖提供了补救手段构造器注入的循环依赖从来救不了。第 9 行Transactional会让OrderServiceImpl在初始化后被 AOP 包成一个代理对象。加上这行之后容器里最终存的不再是那个原始对象。第 18 行的反向注入让两个 bean 形成闭环谁先创建谁就要走「提前暴露」的流程。问题就出在CouponServiceImpl在半路拿到的是OrderServiceImpl的原始对象引用而容器最后放进去的是代理对象。两个引用对不上Spring 检测到不一致直接抛异常。三级缓存到底是哪三级翻DefaultSingletonBeanRegistry的源码三个 Map 的定义就在类顶部public class DefaultSingletonBeanRegistry extends SimpleAliasRegistry implements SingletonBeanRegistry { /** 一级缓存完全初始化好的成品 bean */ private final MapString, Object singletonObjects new ConcurrentHashMap(256); /** 三级缓存bean 的工厂用来按需生成早期引用 */ private final MapString, ObjectFactory? singletonFactories new HashMap(16); /** 二级缓存从三级工厂产出的早期引用可能已经是代理 */ private final MapString, Object earlySingletonObjects new HashMap(16); protected Object getSingleton(String beanName, boolean allowEarlyReference) { Object singletonObject this.singletonObjects.get(beanName); if (singletonObject null isSingletonCurrentlyInCreation(beanName)) { synchronized (this.singletonObjects) { 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; } }这段代码值得逐行读查找顺序是一级 → 二级 → 三级逐级降级。命中一级说明 bean 已完全就绪直接返回。isSingletonCurrentlyInCreation是循环依赖的判定开关只有当这个 bean 正在创建中才允许去翻二三级缓存。singletonFactory.getObject()是整个机制的核心它不是简单地返回原始对象而是执行一段可能产生代理的逻辑。产出后立刻把结果挪到二级缓存并删掉三级工厂保证同一个 bean 的早期引用只生成一次多次注入拿到的是同一个对象。很多人背八股背成「一级放成品、二级放半成品、三级放工厂」就停了。真正该问的是为什么不能只用两级答案就在getObject()里。三级缓存的真正用途给 AOP 留后门三级缓存里放的工厂是在doCreateBean里注册的// AbstractAutowireCapableBeanFactory#doCreateBean 片段 boolean earlySingletonExposure (mbd.isSingleton() this.allowCircularReferences isSingletonCurrentlyInCreation(beanName)); if (earlySingletonExposure) { // 注册三级工厂注意这里传的是 lambda不是对象本身 addSingletonFactory(beanName, () - getEarlyBeanReference(mbd, beanName, bean)); } // 填充属性此处触发对 couponService 的注入进而递归创建 CouponServiceImpl populateBean(beanName, mbd, instanceWrapper); // 执行初始化AOP 在这里正常织入 exposedObject initializeBean(beanName, exposedObject, mbd); protected Object getEarlyBeanReference(RootBeanDefinition mbd, String beanName, Object bean) { Object exposedObject bean; for (BeanPostProcessor bp : getBeanPostProcessors()) { if (bp instanceof SmartInstantiationAwareBeanPostProcessor) { SmartInstantiationAwareBeanPostProcessor ibp (SmartInstantiationAwareBeanPostProcessor) bp; // AbstractAutoProxyCreator 在这里提前把 bean 包成代理 exposedObject ibp.getEarlyBeanReference(exposedObject, beanName); } } return exposedObject; }理解要点addSingletonFactory传进去的是lambda 而非对象。也就是说「要不要生成代理」这个决定被延后了——没有循环依赖就永远不执行有循环依赖才执行。getEarlyBeanReference会走一遍SmartInstantiationAwareBeanPostProcessorAOP 的AbstractAutoProxyCreator正是在这里把 bean 提前包成代理。如果只有两级缓存直接把原始对象放进二级那么所有bean 在被提前暴露时都得先判断要不要代理等于把 AOP 时机整体前移破坏了「初始化后织入」的语义。三级缓存的价值就是这个「延迟决策」。到这里我们的报错为什么会发生也就清楚了正常情况下getEarlyBeanReference提前生成的代理会被记住最后exposedObject会和它保持一致。而我们那次的问题在于——OrderServiceImpl上还挂了一个自定义的BeanPostProcessor它在postProcessAfterInitialization里又包了一层自定义代理导致最终对象和早期暴露的代理不是同一个。Spring 在doCreateBean尾部做一致性校验时发现对不上就抛了那个异常。排查过程中最耗时间的两小时说实话最初我们完全跑偏了。因为异常信息里带着couponServiceImpl我们花了将近两小时在优惠券服务上找问题把它的依赖树画了一遍甚至怀疑是 Feign 客户端的代理。真正的转折点是加了一行调试Component public class BeanRefDebugger implements ApplicationListenerContextRefreshedEvent { Autowired private ApplicationContext ctx; Override public void onApplicationEvent(ContextRefreshedEvent event) { Object order ctx.getBean(orderServiceImpl); CouponServiceImpl coupon ctx.getBean(CouponServiceImpl.class); // 打印两处引用的 identityHashCode看是不是同一个对象 System.out.println(容器中的 order System.identityHashCode(order) , class order.getClass().getName()); System.out.println(coupon 持有的 order System.identityHashCode(ReflectionTestUtils.getField(coupon, orderService))); } }打印结果一目了然容器里的是OrderServiceImpl$$EnhancerBySpringCGLIB$$xxx而couponServiceImpl手里握的是另一个 hash 的对象。问题从来不在优惠券服务在我们自己那个多余的 BeanPostProcessor 上。这个教训后来写进了组内的排查手册遇到循环依赖报错先别看异常里点名的那个 bean先用identityHashCode把「容器里的」和「被注入的」两个引用打出来比一比比读一小时源码管用。几种解法的真实取舍方案改动量副作用我的态度spring.main.allow-circular-referencestrue一行配置把设计问题掩盖Spring Boot 2.6 默认关它是有道理的不建议只当临时止血Lazy注入一个注解注入的是代理首次调用才初始化调试栈变深可接受适合救火ObjectProviderT延迟获取改几行代码语义清晰无隐式代理推荐比Lazy显式抽公共逻辑到第三个 bean改动最大需要重新划分职责长期方案我们最后选的这个改用 setter 注入绕开构造器循环中等只是绕过环还在不解决根因我们最终的处理是把OrderServiceImpl里调用优惠券的那段抽成OrderCouponFacade让两个 service 都依赖它环直接断掉。改完之后不仅启动正常链路也清爽了——之前那个环本身就是职责划分没做好的信号。如果只是想快速上线ObjectProvider是我更推荐的临时方案Service public class CouponServiceImpl implements CouponService { private final ObjectProviderOrderService orderServiceProvider; public CouponServiceImpl(ObjectProviderOrderService orderServiceProvider) { // 构造器里只存 provider不触发 OrderService 的创建 this.orderServiceProvider orderServiceProvider; } Override public void deduct(Long userId) { // 真正用到时才去容器里取此时对方已经是完整的代理对象 OrderService orderService orderServiceProvider.getObject(); orderService.markCouponUsed(userId); } }这段的好处是构造器注入的语义保住了依赖仍然是 final 的同时把「取实例」的时机推到方法调用时环在启动阶段就不成立了。相比Lazy读代码的人一眼能看出这里做了延迟不需要去猜注解背后的行为。复盘数据几个真实数字从报错到定位根因2 小时 40 分钟其中 2 小时浪费在错误的 bean 上。涉及的 bean 数量整个环只有 2 个类但被间接牵连的自动装配 bean 有17 个。升级到 Spring Boot 2.6.6 后同样的代码启动阶段直接被allow-circular-references默认关闭拦下报错更早、信息更明确。2.6 那个「不友好」的默认值其实帮我们提前暴露了问题。重构后订单服务启动时间从 18.4s 降到 16.9s虽然不是重构目标但少了一层多余代理确实有收益。我的判断三级缓存是一套为已有设计缺陷兜底的补救机制不是可以依赖的特性。Spring 官方从 2.6 开始默认禁止循环依赖态度已经很明确了。我不建议在新代码里靠allow-circular-references过日子。它能让你今天上线但会让下一个人在某个周三早上对着BeanCurrentlyInCreationException发呆。真正划算的做法是看到环先怀疑职责划分而不是先找 Spring 的开关。反过来说如果你维护的是一个五年以上的老系统几十个 bean 缠在一起那么理解三级缓存的意义就完全不同了——它是你在不重构的前提下继续活下去的知识储备。这类系统里ObjectProvider加注释说明是我见过性价比最高的处理方式。留个问题如果OrderServiceImpl改成构造器注入CouponService三级缓存还救得了吗为什么提示想想addSingletonFactory是在实例化之后、属性填充之前调用的而构造器注入需要在实例化那一刻就拿到依赖。欢迎在评论区写下你的答案也欢迎贴出你遇到过的最离谱的一个循环依赖现场。
延伸阅读

更多相关文章

2026/11/13 7:47:47

Akagi雀魂助手:终极免费AI教练真的能快速提升麻将水平吗?

Akagi雀魂助手:终极免费AI教练真的能快速提升麻将水平吗? 【免费下载链接】Akagi 支持雀魂、天鳳、麻雀一番街、天月麻將,能夠使用自定義的AI模型實時分析對局並給出建議,內建Mortal AI作為示例。 Supports Majsoul, Tenhou, Riic…

2026/11/16 13:34:07

北京市考电工证值不值得考?避坑指南来了

北京市考电工证值不值得考?避坑指南来了 你是不是正在为【北京市考电工证】发愁?不知道该去哪报名,怕被中介坑,还担心这证到底值不值得考?这些问题都是新手常遇到的,今天我就从一线从业者角度,给你说清楚怎么报名、怎么考、怎么避免被坑,以及这个证到…

2026/11/16 13:34:07

晋城哪里学电工证?上岗必备的避坑指南来了

晋城哪里学电工证?上岗必备的避坑指南来了 你是不是也遇到过这样的问题: 不知道去哪报名怕被中介坑 ?尤其是像 晋城哪里学电工证 这种问题,找不对地方,不仅浪费时间、金钱,还可能拿到假证,影响以后的工作机会。电工证是 上岗必备…

2026/11/16 13:34:07

青岛电工作业证过期了不知道怎么复审在哪考

青岛电工作业证过期了不知道怎么复审在哪考 证书过期了不知道怎么复审延期,这事儿我太熟了,去年还有个朋友在安阳,电工证快到期了,愣是不知道去哪儿续,结果项目丢了,收入也跟着跌了。别急,今天就把青岛电工作业证的复审流程、在哪考、还有薪资前景一锅…

2026/11/16 13:34:07

江苏怎样可以拿电工证官方报名入口在哪里怎么考

江苏怎样可以拿电工证官方报名入口在哪里怎么考 怕考不过白交培训费?江苏电工证报名别走弯路,官方入口和流程都在这! ### 电工证在江苏能干什么?岗位职责和执业范围必须知道 在江苏从事电工相关工作的朋友, 电工证…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/16 0:00:11

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱 你是不是也和我一样,想考电工证,但不知道去哪报名,怕被中介坑?最近网上有不少人问“黎城电工证查询报名费多少钱”,结果一查,信息五花八门,真假难辨。别担心,今天我就从一线从业者的角度…

2026/11/16 0:00:11

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来?

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来? 之前考的证在外省能不能转过来?这个问题困扰着很多在外地打工的电工,尤其是像南阳卧龙区的建筑工人,他们常年在工地作业,手上持有电工证是基本要求,但很多人因为工作流动性大,担心证书不能转到本…

2026/11/15 4:46:37

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑