You need to enable JavaScript to run this app. Spring Boot 2.1.3+使用@Autowired字段注入为何仍报循环引用错误
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot 2.1.3+使用@Autowired字段注入为何仍报循环引用错误

问题触发原因
  1. 版本行为差异的核心背景
    Spring Boot 2.1.3 将内置的Spring Framework从5.1.4升级到5.1.5,该版本新增了循环依赖场景下的实例一致性强校验逻辑,这是同一段代码在低版本能跑、高版本报错的根本原因。
  2. 结合代码的完整触发链路
    • 代码本身存在闭合的字段注入循环依赖:ABillServiceImpl继承CommonBillService,而CommonBillService中通过字段注入onlineProfitServiceImpl;OnlineProfitServiceImpl中又通过字段注入aBillServiceImpl,形成完整的双向依赖环。
    • 2.1.2版本的“能跑通”是建立在无强校验的缺陷之上:旧版本创建aBillServiceImpl时,会把未经过AOP包装、未完成后置处理的原始实例放到三级缓存中提前暴露。后续创建onlineProfitServiceImpl时,直接从三级缓存拿到这个原始aBillServiceImpl实例完成属性填充,哪怕最后aBillServiceImpl因为需要被AOP织入、被其他BeanPostProcessor处理生成了和原始实例不一致的代理对象,也不会做一致性校验。这种运行状态本身存在隐患:onlineProfitServiceImpl持有的是未被代理的原始对象,很容易出现事务失效、切面逻辑不生效的问题,只是没有做强制报错而已。
    • 新版本的校验拦截逻辑:5.1.5版本开始,Spring新增了检查规则——如果某个bean作为早期引用被注入给其他bean之后,最终的实例被后置处理包装(比如生成AOP代理、被其他后置处理器修改),就直接抛出你看到的报错,避免不同bean持有同一个目标的不同实例,出现行为不一致的问题。
  3. 容易被忽略的细节
    你在ABillServiceImpl子类中没有显式注入OnlineProfitService,但相关依赖是从父类CommonBillService继承而来的,很容易误以为没有形成循环,实际上依赖环是完整闭合的。

补充说明:你提到“仅使用@Autowired字段注入按理说不应当触发循环引用错误”,这个认知是对旧版本Spring行为的总结——Spring确实通过三级缓存机制默认支持字段注入的循环依赖,但这种支持有严格前提:循环链路中暴露的早期实例,最终不能被后置处理修改。一旦早期注入的原始实例和最终实例不一致,哪怕是字段注入的场景,也会触发报错,和注入方式没有直接关系。

可落地的解决方式
  • 快速修复方案:在循环链路的任意一处注入字段上加@Lazy注解
    比如在CommonBillService的profitService字段、或者OnlineProfitServiceImpl的aBillService字段上加@Lazy。原理是加了懒加载后,Spring会为依赖生成一个轻量代理,初始阶段不会立刻获取真实的bean实例,等实际调用方法时才会触发bean的完整初始化、代理生成流程,从根源上避免“提前注入原始实例,后续实例被修改”的问题。
  • 架构根治方案:重构双向依赖
    把两个类之间互相调用的公共逻辑抽离到独立的第三方Service中,让两个类都依赖这个抽离出来的类,彻底取消相互直接注入的循环链路,从根源上消除隐患。
  • 临时应急方案:手动调整AOP代理生成时机
    通过自定义BeanPostProcessor,调整AOP代理的生成顺序,让aBillServiceImpl的代理在暴露早期引用前就生成完成,保证注入给其他bean的实例就是最终的代理对象。这个方案对代码侵入性强,稳定性差,仅适合临时上线应急,不推荐长期维护。

注意:仅配置spring.main.allow-circular-references=true无法解决这个报错,这个配置仅控制是否允许Spring通过三级缓存提前暴露早期bean实例,而本次报错的核心是“提前暴露的原始实例和最终实例不一致”的一致性校验,和该开关无关。

内容的提问来源于stack exchange,提问作者frank

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 21:36:03