关于springboot启动配置加载的那点事儿

前言

现在几乎所有的java开发都会用到springboot,除了很老很老的项目,应该不会再有人直接用jsp,servlet等写web项目了吧,直接用spring的都很少见了。
今天发生的这个问题就得从springboot说起。我们都知道springboot遵循约定大于配置的规则,尽量将spring中的配置减少,几行代码就可以跑一个web项目,但是默认的东西越多,其实隐藏的东西也就越多,一旦碰到什么问题,如果没点准备,真的是会手忙脚乱的。

问题描述

说起来也不复杂,新拆分了一个项目,公司用的apollo作为配置中心,所以要做一些基本配置,让新项目从apollo拉取配置。本以为简单的Ctrl+C,Ctrl+V搞定,结果启动的时候报dubbo配置找不到,反复查看apollo,一个字母一个字母的比对过去,确定配置没有配错的,但是怎么就找不到呢?

源码分析

一般这种问题想从网上找到答案的可能性微乎其微,只好自己动手,深入源码,看看到底是哪个妖怪在作祟。

SpringApplicationRunListener和ApplicationContextInitializer

Dubbo配置的加载是架构组jar包提供的,定义了一个SpringApplicationRunListener的实现类,而apollo的配置加载是在ApplicationContextInitializer的一个实现类ApolloApplicationContextInitializer中处理的。所以一开始的怀疑Listener和Initializer在应用启动的时候的顺序问题。
因为DubboListener里面加载dubbo的配置的代码在SpringApplicationRunListener的contextLoaded方法中,多以可以从下面SpringApplication的源码看到,Initializer的initialize方法是在Listener的contextLoaded方法之前执行的

private void prepareContext(ConfigurableApplicationContext context,
            ConfigurableEnvironment environment, SpringApplicationRunListeners listeners,
            ApplicationArguments applicationArguments, Banner printedBanner) {
    context.setEnvironment(environment);
    postProcessApplicationContext(context);
    // Initializer的initialize方法在这里执行
    applyInitializers(context);
    listeners.contextPrepared(context);
    if (this.logStartupInfo) {
        logStartupInfo(context.getParent() == null);
        logStartupProfileInfo(context);
    }

    // Add boot specific singleton beans
    context.getBeanFactory().registerSingleton("springApplicationArguments",
            applicationArguments);
    if (printedBanner != null) {
        context.getBeanFactory().registerSingleton("springBootBanner", printedBanner);
    }

    // Load the sources
    Set<Object> sources = getAllSources();
    Assert.notEmpty(sources, "Sources must not be empty");
    load(context, sources.toArray(new Object[0]));
    // Listener的contextLoaded方法在这里执行
    listeners.contextLoaded(context);
}

debug源码

猜测不对,只好跟着启动的源码debug观察了。这里省略一开始的猜测和尝试,直接进入重点:调试的时候有个发现,apollo的是否启用的配置值居然是false!可以从代码看到,方法直接返回了,并没有去加载apollo中的配置值,所以并不是顺序有问题,而是一开始是否启用的配置值有问题。

public void initialize(ConfigurableApplicationContext context) {
    ConfigurableEnvironment environment = context.getEnvironment();

    initializeSystemProperty(environment);
    // 如果这里配置是false,那方法直接return了
    String enabled = environment.getProperty(PropertySourcesConstants.APOLLO_BOOTSTRAP_ENABLED, "false");
    if (!Boolean.valueOf(enabled)) {
      logger.debug("Apollo bootstrap config is not enabled for context {}, see property: ${{}}", context, PropertySourcesConstants.APOLLO_BOOTSTRAP_ENABLED);
      return;
    }
    // 省略

查看项目中的application.properties文件,没啥问题啊(本来就是其他项目拷过来的,能有啥问题),那怎么就读成false了呢?

apollo.bootstrap.enabled=true
apollo.bootstrap.namespaces=application,dev.common

只好继续debug让人头大的源码,还是略过那些不重要的代码,直接来看重点和结论:

  1. 第一次进入SimpleApplicationEventMulticaster的这个方法,这个时候其实是应用启动事件,发现有4个监听器,但看上去没一个像跟配置有关的


  2. 第二次进这个方法,这个时候事件类型是环境准备事件,其中有个监听器是ConfigFileApplicationListener


  3. 进入ConfigFileApplicationListener的事件处理方法


  4. 通过ConfigFileApplicationListener的方法调用链onApplicationEnvironmentPreparedEvent --> postProcessEnvironment --> addPropertySources直接进入到内部类Loader的下面这个方法,其中常量NO_SEARCH_NAMES是包含单个null元素的集合,这里获取到的names就是配置文件的名称。
private void load(Profile profile, DocumentFilterFactory filterFactory,
                DocumentConsumer consumer) {
    getSearchLocations().forEach((location) -> {
        boolean isFolder = location.endsWith("/");
        Set<String> names = (isFolder ? getSearchNames() : NO_SEARCH_NAMES);
        names.forEach(
                (name) -> load(location, name, profile, filterFactory, consumer));
    });
}
  1. 小心翼翼的一步一步往下走,本以为不会走进if条件,这样读到的就是application配置文件了,结果居然走了进去,而且"spring.config.name"对应的value是boostrap,而项目里根本没有配置boostrap.yaml文件,那这个值是哪来的呢?


  2. 找了个能正常启动的项目,同样的地方打上了断点,发现没进if条件,"spring.config.name"这个配置到底什么时候设置进去的,反复debug了好几遍,发现出错的应用多了一个监听器BootstrapApplicationListener,而这个监听器的优先级如下,比ConfigFileApplicationListener小多了(越小优先级越高)
public static final int DEFAULT_ORDER = Ordered.HIGHEST_PRECEDENCE + 5;

  1. 现在就剩一个问题了,为啥会多这么一个监听器呢?这个类所在的jar包是spring-cloud-context,分析了依赖发现正常启动的应用果然是没有这个依赖的。

结论

有时候默认的约定会给开发人员带来一定的困扰,就像springcloud默认会去读bootstrap的配置一样,而差别仅仅是依赖中是否含有对应的jar包。本篇的问题其实还有一种解决方案,就是直接将application.properties里的配置移动到bootstrap.properties里,这样apollo启用的配置就能从bootstrap.properties里读到了。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,012评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,589评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,819评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,652评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,954评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,381评论 1 210
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,687评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,404评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,082评论 1 238
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,355评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,880评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,249评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,864评论 3 232
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,007评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,760评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,394评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,281评论 2 259

推荐阅读更多精彩内容