# 问题引入

SpringBoot最核心的一个东西就是自动配置，自动配置的原理是什么？

我们知道Spring最开始是通过xml文件配置，来告诉Spring要创建哪些类、哪些Bean。

后来进化为可以通过注解来配置，这样就不用去写xml文件了，只需要告诉Spring去扫描哪些包就可以了。

那么问题来了，如果是一个三方服务框架包，我怎么知道要去扫描哪些包呢？

很多时候我们还是只能通过@Bean的方式去创建，一些复杂的服务可能需要创建很多Bean，我们怎么知道要创建哪些Bean呢？这些Bean的关联关系又是怎样的呢？

用起来太麻烦了，很多时候，我们并不想知道实现的具体细节，我们只希望拿来就能用，怎么办呢？

于是：SpringBoot来了，它可以自动完成配置，创建并注入需要的Bean，不需要我们自己去创建了，若有的创建Bean的工作都由提供服务的服务者去创建，他们自己实现的，当然更清楚怎么用，怎么创建系列Bean。


那么，问题又来了，SpringBoot是怎么做到自动配置的呢？

答案是：类Java SPI机制。

# Java SPI机制

一个好的语言、框架设计时候一定要考虑好扩展，做好抽象层。

例如Java的数据库驱动就是一个好的例子，我们使用的都是java.sql包下的抽象层接口，根本不用关心是哪种数据库，实现细节是什么。

一个不好的例子，就是Java的日志功能，所以抽象做得更好的slf4j-api基本就成了共用接口标准。

当然，技术在不断发展，很多时候，我们再设计的时候并不能考虑到那么多，例如响应式编程，那也是发展了很多年，才有[projectreactor](https://projectreactor.io/)

Java的数据库驱动为什么能让我们不用关心具体实现呢，答案就是:SPI(Service Provider Interface)。

Java SPI核心类是：java.util.ServiceLoader

它会去扫描classpath下的META-INF/services目录下的文件，文件名是抽象层的全限定名，例如java.sql.Driver，文件内容是服务提供的具体实现类。

如：com.mysql.cj.jdbc.Driver

![1-Druid-SPI-Driver.png](https://developer.qcloudimg.com/http-save/yehe-5417028/d558277ab40fc6a8cb13660f26f86298.png)

# @EnableAutoConfiguration

Java SPI的核心类是ServiceLoader，SpringBoot自动配置的核心类是@EnableAutoConfiguration。

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

EnableAutoConfiguration它通过@Import(AutoConfigurationImportSelector.class)自动装配了AutoConfigurationImportSelector类。

```java
public class AutoConfigurationImportSelector implements DeferredImportSelector, BeanClassLoaderAware,
        ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered {
}
```

AutoConfigurationImportSelector实现了DeferredImportSelector接口，DeferredImportSelector又实现了ImportSelector。

ImportSelector#selectImports就可以告诉Spring这些类需要被导入。

那AutoConfigurationImportSelector会去哪里找需要自动装配的类呢？

顺着接口selectImports找呗，有兴趣可以自己去跟源码，这里简单总结一下：

1. ImportCandidates.load(AutoConfiguration.class, getBeanClassLoader())
2. 找的是AutoConfiguration类
3. META-INF/spring/要找的类的全限定名称.imports文件
4. 所以：META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
5. 上面的文件配置的类，每行一个全部导入

还有一个ImportAutoConfigurationImportSelector，是处理ImportAutoConfiguration。

![2-imports.png](https://developer.qcloudimg.com/http-save/yehe-5417028/9e00ce8f0b3577f2db33bb175d984b4f.png)

除了直接导入的，还有通过org.springframework.core.io.support.SpringFactoriesLoader#loadFactoryNames导入，找的是META-INF/spring.factories文件。

spring.factories这个文件中的内容类似properties，是key-value形式，key是接口全限定名，value是具体实现类全限定名，多个逗号分隔。

![3-spring-factories.png](https://developer.qcloudimg.com/http-save/yehe-5417028/8230fbd75238a4834dc40ef6242de367.png)

对于自动导入来说，具体的接口是org.springframework.boot.autoconfigure.EnableAutoConfiguration。

例如：

```java
@Import({DruidSpringAopConfiguration.class,
        DruidStatViewServletConfiguration.class,
        DruidWebStatFilterConfiguration.class,
        DruidFilterConfiguration.class})
public class DruidDataSourceAutoConfigure {}
```

对过对于EnableAutoConfiguration，还是推荐使用新的规范，仍在META-INF\spring\org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中，这样不用配置key，也不用考虑多行的问题，直接每行一个就行。


# 实现自己的EnableMyAutoConfiguration

知道了原理，我们可以动手实现一个我们自己的EnableMyAutoConfiguration。

首先是Enable注解：

```java
import org.springframework.context.annotation.Import;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Import(MyAutoConfigurationImportSelector.class)
public @interface EnableMyAutoConfiguration {
}
```

然后是，我们需要处理什么注解呢？我们自定义的MyAutoConfiguration

```java
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAutoConfiguration {
}
```

接下来，我们需要一个DeferredImportSelector来加载配置的MyAutoConfiguration类。

```java
import org.springframework.boot.context.annotation.ImportCandidates;
import org.springframework.context.annotation.DeferredImportSelector;
import org.springframework.core.type.AnnotationMetadata;

import java.util.List;

public class MyAutoConfigurationImportSelector implements DeferredImportSelector {

    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        List<String> configurations = ImportCandidates.load(MyAutoConfiguration.class, this.getClass().getClassLoader())
                .getCandidates();
        return configurations.toArray(new String[0]);
    }
}
```

使用了@MyAutoConfiguration的配置类：

```java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Import;

@MyAutoConfiguration
@Import(BzClass.class)
public class ConfigurationA {

    @Bean
    public String name(){
        return "ConfigurationA";
    }
}
```

配置类中导入了具体的业务类：

```java
public class BzClass {
}
```

然后我们把配置类vip.oschool.custom.ConfigurationA，配置到META-INF\spring\vip.oschool.custom.MyAutoConfiguration.imports文件中。

然后，来一个启动类：

```java
import org.springframework.context.annotation.ConfigurationClassPostProcessor;
import org.springframework.context.support.GenericApplicationContext;

@EnableMyAutoConfiguration
public class Main {
    public static void main(String[] args) {
        GenericApplicationContext context = new GenericApplicationContext();
        context.registerBean("main", Main.class);
        // ConfigurationClassPostProcessor处理DeferredImportSelector
        context.registerBean(ConfigurationClassPostProcessor.class);
        context.refresh();
        for (String beanName : context.getBeanDefinitionNames()) {
            System.out.println(beanName);
        }
    }
}
```

![5-自定义实现.png](https://developer.qcloudimg.com/http-save/yehe-5417028/2f4973a0fd4801b9bbaafeae60a586cc.png)

结果，我们可以看到，所有的配置类都被加载了。

# starter

知道了自动配置原理，再来看starter就想吃饭喝水一样简单了。

通常我们自己的state人的artifactId是xxxx-spring-boot-starter，spring自己的stater是spring-boot-starter-xxxx

druid-spring-boot-starter就是把配置类添加到了spring.factories
![6-druid.png](https://developer.qcloudimg.com/http-save/yehe-5417028/3b6f5f7120056a0d68474d45820497bc.png)

DruidDataSourceAutoConfigure创建了DruidDataSourceWrapper，又通过@Import导入DruidSpringAopConfiguration等实际业务类。

所以，我们什么都不用管，只需要把druid-spring-boot-starter添加入依赖就可以用了，因为DruidSpringAopConfiguration都帮我们创建好了。

当然，关联的依赖也在druid-spring-boot-starter的pom.xml中导入了。

还有一些更符合Spring模式的，例如，会单独有一个autoconfigure项目来管理自动配置。

自动配置的类配置在META-INF\spring\org.springframework.boot.autoconfigure.AutoConfiguration.imports文件。

![7-mybatis.png](https://developer.qcloudimg.com/http-save/yehe-5417028/77e53bd0f752c45500de7e5c5ae71dca.png)

我们知道Spring最开始是通过xml文件配置，来告诉Spring要创建哪些类、哪些Bean。

SpringBoot自动配置原理

后端

架构设计

开发工具

SpringBoot自动配置原理基于Java SPI机制，通过@EnableAutoConfiguration注解和META-INF/spring/目录下的配置文件实现。核心是AutoConfigurationImportSelector类扫描配置文件，自动加载配置类并创建Bean。开发者只需引入starter依赖，SpringBoot就能自动完成复杂配置，无需手动创建Bean。

数据库

Java

AI驱动 智领未来

tencentdb-catalog

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

SpringBoot自动配置原理基于Java SPI机制，通过@EnableAutoConfiguration注解和META-INF/spring/目录下的配置文件实现。核心是AutoConfigurationImportSelector类扫描配置文件，自动加载配置类并创建Bean。开发者只需引入starter依赖，S...

SpringBoot自动配置原理-腾讯云开发者社区-腾讯云

SpringBoot自动配置原理

SpringBoot自动配置原理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐