Springboot Configuration 和 AutoConfiguraton

遇到一个问题,报上来一个app加入一个lib,启动就突然失败了。报了一个Autowire错误 NullPointerException。但是奇怪的是,大部分其他的App 加入这个library 之后都风平浪静,一切正常。那么这个app有何特殊之处?

首先要解决这个NullPointerException 为何会出现. 这个出错的是个AutoConfiguration 类

 package io.http.env.client;
@Configuration
@AutoConfigureAfter(name = { "com.metadata.MetadataInitializer"})
public class HttpEnvInitializer {

    @Autowired
    public HttpEnvInitializer(SpellFasterServiceClient client){
      client.call()
         ....
    }
}

spring.factories 的配置类似

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
io.montage.env.client.HttpEnvInitializer

这个SpellCasterServiceClient 的bean 应该出现在这个AutoConfig 里

package io.montage.env.client;
@AutoConfigureBefore(name = { "com.metadata.MetadataInitializer" })
public class MFClientInitializer {
  @Bean
  public SpellFasterServiceClient  getSpellFasterServiceClient() {
    
       return SpellFasterServiceClientBuilder.target().build();
}

spring.factories 的配置类似

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
io.montage.env.client.SpellFasterServiceClient

这就是不科学了,构造SpellFasterServiceClient 的顺序在com.metadata.MetadataInitializer 之前,注入句柄的是在com.metadata.MetadataInitializer之后,这看起完全没有问题。
从程序看来,这个运行顺序完全没有问题

MFClientInitializer ->MetadataInitializer->HttpEnvInitializer

但是实际呢,通过debug 可以看到顺序是这样的

HttpEnvInitializer->MFClientInitializer ->MetadataInitializer

这就奇怪了,为啥AutoConfig 的before 和after 这些annotation 不起作用了?

需要看看什么导致了顺序变化,发现有人在Application 类新加了一个@ComponentScan("io.montage.env"),这下恍然大悟。原来和library 添加无关。


@SpringBootApplication
@EnableAsync
@ComponentScan("io.montage.env")
@Import({WebSpringConfig.class})
public class MonitorManagerApplication {

    public static void main(String[] args) {
        SpringApplication.run(MonitorManagerApplication.class, args);
    }
}

这个@ComponentScan("io.montage.env") 纯属画蛇添足。这也解释了为什么只有这个App有问题,而其他的没问题。

下面就要谈谈Configuration和AutoConfiguration的区别

Configuration和AutoConfiguration

他们都是定义Bean 的一种方式。

相同点:

  • 他们都用@Configuration 做annotation. 他们同样都可以加 @Bean、@Import、@ImportResource.
  • 他们都可以用 @Condition 来控制加载条件.

不同点:

目的:
  • @Configuration 是给Application 的用户,直接代码进行配置的。
  • AutoConfiguration 是给 Springboot 插件俗称starter用的。
加载的方式:
  • @Configuration 加载是由@ComponentScan指定的package,如果没有指定,default 是ApplicationClass 的package 开始。
  • AutoConfiguration 是通过 classpath*:META-INF/spring.factories 来被发现。 通过 key org.springframework.boot.autoconfigure.EnableAutoConfiguration. AutoConfiguration 是由 import selector 的方式加载的, 而不是 scan path.
  • 顺序:正常情况下, @Configuration 先加载 AutoConfiguration后加载。
    请看class ConfigurationClassParser#doProcessConfigurationClass
class ConfigurationClassParser {
    protected final SourceClass doProcessConfigurationClass(
            ConfigurationClass configClass, SourceClass sourceClass, Predicate<String> filter)
            throws IOException {

        if (configClass.getMetadata().isAnnotated(Component.class.getName())) {
            // Recursively process any member (nested) classes first
            processMemberClasses(configClass, sourceClass, filter);
        }

        // Process any @PropertySource annotations
        for (AnnotationAttributes propertySource : AnnotationConfigUtils.attributesForRepeatable(
                sourceClass.getMetadata(), PropertySources.class,
                org.springframework.context.annotation.PropertySource.class)) {
            if (this.environment instanceof ConfigurableEnvironment) {
                processPropertySource(propertySource);
            }
            else {
                logger.info("Ignoring @PropertySource annotation on [" + sourceClass.getMetadata().getClassName() +
                        "]. Reason: Environment must implement ConfigurableEnvironment");
            }
        }

        // Process any @ComponentScan annotations
        Set<AnnotationAttributes> componentScans = AnnotationConfigUtils.attributesForRepeatable(
                sourceClass.getMetadata(), ComponentScans.class, ComponentScan.class);
        if (!componentScans.isEmpty() &&
                !this.conditionEvaluator.shouldSkip(sourceClass.getMetadata(), ConfigurationPhase.REGISTER_BEAN)) {
            for (AnnotationAttributes componentScan : componentScans) {
                // The config class is annotated with @ComponentScan -> perform the scan immediately
                Set<BeanDefinitionHolder> scannedBeanDefinitions =
                        this.componentScanParser.parse(componentScan, sourceClass.getMetadata().getClassName());
                // Check the set of scanned definitions for any further config classes and parse recursively if needed
                for (BeanDefinitionHolder holder : scannedBeanDefinitions) {
                    BeanDefinition bdCand = holder.getBeanDefinition().getOriginatingBeanDefinition();
                    if (bdCand == null) {
                        bdCand = holder.getBeanDefinition();
                    }
                    if (ConfigurationClassUtils.checkConfigurationClassCandidate(bdCand, this.metadataReaderFactory)) {
                        parse(bdCand.getBeanClassName(), holder.getBeanName());
                    }
                }
            }
        }

        // Process any @Import annotations
        processImports(configClass, sourceClass, getImports(sourceClass), filter, true);

        // Process any @ImportResource annotations
        AnnotationAttributes importResource =
                AnnotationConfigUtils.attributesFor(sourceClass.getMetadata(), ImportResource.class);
        if (importResource != null) {
            String[] resources = importResource.getStringArray("locations");
            Class<? extends BeanDefinitionReader> readerClass = importResource.getClass("reader");
            for (String resource : resources) {
                String resolvedResource = this.environment.resolveRequiredPlaceholders(resource);
                configClass.addImportedResource(resolvedResource, readerClass);
            }
        }

        // Process individual @Bean methods
        Set<MethodMetadata> beanMethods = retrieveBeanMethodMetadata(sourceClass);
        for (MethodMetadata methodMetadata : beanMethods) {
            configClass.addBeanMethod(new BeanMethod(methodMetadata, configClass));
        }

        // Process default methods on interfaces
        processInterfaces(configClass, sourceClass);

        // Process superclass, if any
        if (sourceClass.getMetadata().hasSuperClass()) {
            String superclass = sourceClass.getMetadata().getSuperClassName();
            if (superclass != null && !superclass.startsWith("java") &&
                    !this.knownSuperclasses.containsKey(superclass)) {
                this.knownSuperclasses.put(superclass, configClass);
                // Superclass found, return its annotation metadata and recurse
                return sourceClass.getSuperClass();
            }
        }

        // No superclass -> processing is complete
        return null;
    }
}

, 先运行下面代码来加载@Configuration

        Set<AnnotationAttributes> componentScans = AnnotationConfigUtils.attributesForRepeatable(
                sourceClass.getMetadata(), ComponentScans.class, ComponentScan.class);

然后在运行

processImports(configClass, sourceClass, getImports(sourceClass), filter, true); 

而EnableAutoConfiguration 定义了AutoConfigurationImportSelector,来load 所有的AutoConfig

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
}

有正常就有不正常的情况,看看什么情况下不正常。

异常情况:

AutoConfiguration 可以使用@AutoConfigureOrder 或者 @AutoConfigureBefore、@AutoConfigureAfter

但是下面情况 AutoConfiguration 会破坏顺序,以@Configuraiton 被加载:

  • AutoConfiguration的class 也在 scan path(@ComponentScan) ,所以他就被认为既是Configuration,又是AutoConfiguration。所以会被加载两次。 当以Configuration身份时先被加载。 因此 @AutoConfigureBefore and @AutoConfigureAfter 就不起作用了。
  • AutoConfiguration定义了 BeanPostProcessor。请看BeanPostProcessorAutoConfiguration的逻辑.
  • AutoConfiguration 使用了 ImportBeanDefinitionRegistrar。
  • AutoConfiguration 使用 ImportSelector。

请参考AutoConfigurationImportSelector AutoConfigurationImportSelector了解更多细节.

在前面的问题中, 就是由于io.montage.env 在scan path里,因此 @AutoConfigureBefore and @AutoConfigureAfter 不起作用了。


@SpringBootApplication
@EnableAsync
@ComponentScan("io.montage.env")
@Import({WebSpringConfig.class})
public class MonitorManagerApplication {

    public static void main(String[] args) {
        SpringApplication.run(MonitorManagerApplication.class, args);
    }
}

如何判断初始化顺序不正常:

当然加载顺序没有按照预定设想顺序,是比较难以排查的。介绍大家一个简单的方法。
appContext.getBeanDefinitionNames 中找到相关的bean name,以上图为例,如果是spring.factories 中定义的名字 例如io.montage.env.client.HttpEnvInitializer, 那么就是从AutoConfiguration 拿来的,如果是httpEnvInitializer, 这种就是从scan path 里扫描出来的。这样很容易就可以看到到底是怎么被load进来的。

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

推荐阅读更多精彩内容