news 2026/5/12 13:26:06

SpringBoot自动配置原理

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
SpringBoot自动配置原理

问题引入

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

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

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

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

如:com.mysql.cj.jdbc.Driver

Java SPI Druid Driver

@EnableAutoConfiguration

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

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

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

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。

org.springframework.boot.autoconfigure.AutoConfiguration.imports

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

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

spring.factories

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

例如:

@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注解:

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

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类。

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的配置类:

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"; } }

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

public class BzClass { }

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

然后,来一个启动类:

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); } } }

手动实现自动加载

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

starter

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

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

druid-spring-boot-starter就是把配置类添加到了spring.factories

druid自动配置实现

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文件。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/9 5:32:49

Disk fragmentation碎片整理对训练影响

Disk fragmentation碎片整理对训练影响 在深度学习的日常实践中&#xff0c;我们常常把注意力集中在模型结构、优化器选择或GPU利用率上。然而&#xff0c;一个看似“过时”的话题——磁盘碎片化&#xff0c;却可能正在悄悄拖慢你的训练速度。你是否遇到过这样的情况&#xff1…

作者头像 李华
网站建设 2026/5/9 5:50:33

AI智能体架构与应用:让系统自主完成业务目标的黑科技

文章阐述了AI智能体如何从问答交互发展为能自主理解上下文、规划路径、调用工具的系统。介绍了智能体的三大核心能力突破&#xff08;自主决策、世界模型构建、持续学习&#xff09;&#xff0c;分析了架构设计与应用场景&#xff0c;探讨了技术优势、挑战与伦理问题。文章强调…

作者头像 李华
网站建设 2026/5/11 11:58:05

如何成为一名RPA工程师:从入门到精通的完整指南

在当今数字化转型浪潮中&#xff0c;企业对自动化的需求日益增长。机器人流程自动化&#xff08;Robotic Process Automation, RPA&#xff09;作为一种能够模拟人类操作、自动执行重复性任务的技术&#xff0c;正迅速成为提升运营效率、降低成本的重要工具。而RPA工程师&#…

作者头像 李华
网站建设 2026/5/9 8:48:20

2025最新!专科生必备10个AI论文工具,毕业论文写作全测评

2025最新&#xff01;专科生必备10个AI论文工具&#xff0c;毕业论文写作全测评 2025年专科生论文写作工具测评&#xff1a;为何需要这份榜单&#xff1f; 随着人工智能技术的不断进步&#xff0c;AI论文工具已成为许多专科生完成毕业论文的重要辅助。然而&#xff0c;面对市场…

作者头像 李华