问题背景
我们项目的配置文件一直是通过Apollo进行管理,但是近期由于某些特殊的部署需求,需要使用K8S的原生对象来获取配置,如此一来的话,就需要使用环境变量spring.config.location来指定application.properties
文件的路径,以便动态的获取配置。
说明:项目是一个dubbo项目,配置文件中主要包括一些基础组件的配置、以及dubbo相关的配置。
这时候问题来了,在所有配置及代码都没有变化的情况下,如果不指定环境变量使用本地的application.properties
,则没有异常任何,项目可以正常启动,但是一但通过spring.config.location 来加载配置,则项目会直接启动失败,并报如下异常:
NoSuchBeanDefinitionException
,这个异常前期误导我不少时间,它一般是Spring在容器初始化时,进行依赖注入的时候没有找到对应的bean定义,也就意味着这个bean压根没有被注册到BeanFactory中,这就很奇怪,只是配置文件的加载方式不同,为何会影响到bean的注册?
过程
找不到bean,最常见的问题有两种:要么是配置问题,比如扫描的包配置错误、配置未生效等。要么就是IoC容器的问题,存在多个容器,导致bean隔离。
定位
在这个问题场景下,两种原因都有可能,不过问题可以复现,就比较好解决。我们直接验证一下,最简单粗暴的法子就是断点伺候,对比两种配置加载方式方式的差异。我们知道除了延迟加载的bean之外,所有bean都是在org.springframework.beans.factory.support.DefaultListableBeanFactory#preInstantiateSingletons
初始化的,那么在这个方法里以异常信息中的bean名称,打个条件断点看看
通过断点,可以拿到两个信息
1、通过当前的堆栈,可以看到当前的初始化bean逻辑并不是SpringBoot的IoC容器触发的,而是SpringCloud
2、beanNames,也就是当前beanFactory中所有已注册的bean中,没有加载到任何通过Spring的@Service
注解标识的bean,但是却加载到了所有被Dubbo的@Service
加载到的bean。
这样一来我们可以确定的是确实存在多容器隔离,SpringCloud也会通过BootstrapApplicationListener
这个***创建一个IoC容器,查看官方说明:
A Spring Cloud application operates by creating a “bootstrap” context, which is a parent context for the main application. It is responsible for loading configuration properties from the external sources and for decrypting properties in the local external configuration files. The two contexts share an Environment, which is the source of external properties for any Spring application. By default, bootstrap properties (not bootstrap.properties but properties that are loaded during the bootstrap phase) are added with high precedence, so they cannot be overridden by local configuration.
SpringCloud创建的容器的加载顺序比SpringBoot要早,是它的父容器,并且它们共享同一个Environment。
虽然现在知道了异常产生的原因,但是为什么换了配置加载方式就会由父容器加载?根据上面的第二个信息,被Dubbo注解标识的bean都被加载了,但是这些bean依赖的SpringBean还没有加载进来,这意味着由于配置文件加载方式的变化,导致Dubbo标记的bean加载时机发生的改变。
根因
那接下来就是看一下Dubbo的bean加载逻辑,我们的服务比较老了,使用的spring-boot-starter-dubbo来整合SpringBoot与Dubbo。一般spring-boot-starter都是通过@EnableXXX或spring.factories来自动装载相关的bean,而spring-boot-starter-dubbo没有使用@Enable,那直接找到jar包下的spring.factories
文件,找到对应的Initializer
:
它实现的是ApplicationContextInitiailizer
,这些接口会在准备完Context环境,在prepareContext中调用,那么很明显,父容器肯定先会执行,子容器后执行。 看代码逻辑,它只有在读取到spring.dubbo.scan有值时,才会去注册bean,到这里原因已经比较明显了,使用application.properties时父容器读不到配置,而使用spring.config.location加载配置时,父容器可以读到配置。
配置加载顺序
上面提到的SpringCloud文档中有这么一句话:
By default, bootstrap properties (not bootstrap.properties but properties that are loaded during the bootstrap phase) are added with high precedence
那么通过spring.config.location方式加载属性是不是在bootstrap phase中呢,直接找到SpringCloud的加载类BootstrapApplicationListener
,搜索spring.config.location,发现它确实优先加载
而如果是使用application.properties,那么配置文件则不会被SpringCloud加载到,会由子容器加载。
解决
问题根因找到了,想解决就比较简单了,两种方式:
- 直接关闭SpringCloud的boostrap listener,通过配置
spring.cloud.bootstrap.enabled=false
即可 - 这个问题其实也是dubbo的整合方式不合理导致的,使用Dubbo自带的注解扫描,不使用配置文件的方式
问题其实比较简单,但是挺有意思,分享一下过程与思路*~*
原文链接:https://juejin.cn/post/7053959623966982180