Spring Boot 中的自动配置原理

2025/4/6

向全栈工程师迈进！

一、自动配置

所谓的自动配置原理就是遵循约定大约配置的原则，在boot工程程序启动后，起步依赖中的一些bean对象会自动的注入到IOC容器中。

在讲解Spring Boot 中bean对象的管理的时候，我们注入bean对象的过程如下，但这种方式不是自动注入的。

并没有达到自动配置。而自动配置是当程序在引入spring-boot-starter-web 起步依赖，boot工程在启动后，会自动往ioc容器中注入DispatcherServlet等bean对象，这就是自动配置。那自动配置的原理是什么呢？

二、自动配置原理

在这里只先引入springboot起步核心依赖，而并没有引入spring-boot-starter-web起步依赖。

<!--引入springboot起步核心依赖-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

在没有引入spring-boot-starter-web依赖之前，我们尝试输出spring-boot-starter-web起步依赖会自动注入的bean对象，没有在pom.xml文件中添加改起步依赖时，输出发现根本没有。

package com.example.demo;

import org.springframework.context.ApplicationContext;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Demo1Application {

    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(Demo1Application.class, args);
        System.out.println(context.getBean("dispatcherServlet"));
    }

}

导入依赖spring-boot-starter-web后，再次尝试输出其bean对象，发现成功，当引入依赖后，其bean对象被自动的注入了。

2.1 查看@SpringBootApplication注解源码

是组合了以下三个注解

@SpringBootConfiguration 其本身也是一个组合注解
@EnableAutoConfiguration 其本身也是一个组合注解
@ComponentScan 是Bean扫描的注解

@SpringBootConfiguration的内部代码：

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by FernFlower decompiler)
//

package org.springframework.boot;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.annotation.AliasFor;
import org.springframework.stereotype.Indexed;

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
@Indexed
public @interface SpringBootConfiguration {
    @AliasFor(
        annotation = Configuration.class
    )
    boolean proxyBeanMethods() default true;
}

可以发现在@SpringBootConfiguration内部也是有@Configuration注解的，所以当在启动类上添加注解@SpringBootApplication其实就是也在启动类上添加了@Configuration注解，所以启动类也是一个配置类。

@EnableAutoConfiguration的内部代码：

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by FernFlower decompiler)
//

package org.springframework.boot.autoconfigure;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import org.springframework.context.annotation.Import;

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";

    Class<?>[] exclude() default {};

    String[] excludeName() default {};
}

@EnableAutoConfiguration是自动配置的核心注解，该@EnableAutoConfiguration注解其实组合了@AutoConfigurationPackage和@Import两个注解，在@Import注解中导入实现类AutoConfigurationImportSelector。其AutoConfigurationImportSelector的实现类如下(代码不全)：

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by FernFlower decompiler)
//

package org.springframework.boot.autoconfigure;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.List;
........
import org.springframework.util.StringUtils;

public class AutoConfigurationImportSelector implements DeferredImportSelector, BeanClassLoaderAware, ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered {
    private static final AutoConfigurationEntry EMPTY_ENTRY = new AutoConfigurationEntry();
    private static final String[] NO_IMPORTS = new String[0];
    private static final Log logger = LogFactory.getLog(AutoConfigurationImportSelector.class);
    private static final String PROPERTY_NAME_AUTOCONFIGURE_EXCLUDE = "spring.autoconfigure.exclude";
    private ConfigurableListableBeanFactory beanFactory;
    private Environment environment;
    private ClassLoader beanClassLoader;
    private ResourceLoader resourceLoader;
    private ConfigurationClassFilter configurationClassFilter;

    public AutoConfigurationImportSelector() {
    }

    ............

        private MetadataReaderFactory getMetadataReaderFactory() {
            try {
                return (MetadataReaderFactory)this.beanFactory.getBean("org.springframework.boot.autoconfigure.internalCachingMetadataReaderFactory", MetadataReaderFactory.class);
            } catch (NoSuchBeanDefinitionException var2) {
                return new CachingMetadataReaderFactory(this.resourceLoader);
            }
        }
    }
}

可以发现在这个实现类（AutoConfigurationImportSelector）中，会从 META-INF/spring.factories 文件中读取所有自动配置类，它读取的 key 是：

org.springframework.boot.autoconfigure.EnableAutoConfiguration

加载所有配置类，条件匹配后注册为 Bean。

2.2 自动配置原理——举个栗子🧩

核心：

AutoConfigurationImportSelector 会从 META-INF/spring.factories 文件中读取所有自动配置类，它读取的 key 是：org.springframework.boot.autoconfigure.EnableAutoConfiguration。

✅ 你写了一个 Spring Boot 项目，启动类是这样的：

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

这个注解其实包含了 @EnableAutoConfiguration，表示：

“嘿 SpringBoot，我想用你自动帮我配置一些常见功能，比如数据库、Web、Redis 等！”

🧠 那 SpringBoot 是怎么知道你要配置啥的？

这时候就轮到 AutoConfigurationImportSelector 出场了！

它是一个“选择器”，全名叫：

org.springframework.boot.autoconfigure.AutoConfigurationImportSelector

它的作用是：

🧭“我去找一个叫 spring.factories 的文件，里面写了：SpringBoot 应该自动配置哪些类。我一个个加载它们，看看哪个需要用，哪个可以跳过。”

📂 spring.factories 是什么？

它是一个纯文本配置文件，路径在：

classpath:/META-INF/spring.factories

这个文件来自哪个 jar 包？👉 就是 Spring Boot 的依赖包之一：

spring-boot-autoconfigure-xxx.jar

打开看一下这个文件长什么样：

# 配置项的 key
org.springframework.boot.autoconfigure.EnableAutoConfiguration=

# 配置的值（每一行都是一个自动配置类，全限定类名）
org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration,\
org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration,\
org.springframework.boot.autoconfigure.redis.RedisAutoConfiguration

🌟 所以：Spring Boot 会遍历所有这些类，一个个判断：