SpringBoot自动化配置原理和自定义starter方式

SpringBoot自动化配置原理和自定义starter

SpringBoot最让人上头的特性是什么？自动化配置绝对算一个。不用写一堆XML，不用手动组装Bean，引入一个starter就能开箱即用。但背后的机制到底是怎么跑的？弄明白这个，自己动手写个starter也就不难了。

SpringBootConfiguration

这个注解底层其实就是一个@Configuration，意味着启动类本身就是一个配置类。既然它是配置类，那在里面定义Bean当然没问题。

ComponentScan

组件扫描，默认会扫描启动类所在包及其子包下所有被Spring注解标记的组件。说白了，你只要把代码放在启动类的“眼皮底下”，它就能自动发现。

EnableAutoConfiguration

这才是自动化配置的核心开关。它底层是一个@Import注解，导入了一个关键类——AutoConfigurationImportSelector。

这个类实现了ImportSelector接口，Spring容器在初始化时会调用它的selectImports方法。

selectImports()方法内部调用了getAutoConfigurationEntry()，这一步会拿到所有“候选的”自动配置类信息。

而getAutoConfigurationEntry()又通过getCandidateConfigurations()去读取配置文件里注册的那些自动配置类全限定名。

读哪个文件呢？就是META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports。这个文件里把Spring Boot官方以及第三方starter的所有自动配置类都列了个清单。

拿到清单之后，框架会做一道筛选：只保留那些满足starter条件、以及@Conditional一系列条件判断的类。最终把这些符合条件的全类名打包成一个字符串数组，加载到内存里。

启动类通过run()方法创建并初始化Spring容器，初始化时就会把这些“候选名单”里的类实例化成Bean，注入容器。至此，自动化装配就完成了。

自定义starter

理解了上面的流程，自定义starter就变得有章可循了。说起来并不复杂，核心就是两条线：依赖管理和自动配置。

首先，创建一个starter模块，命名推荐用方法名-spring-boot-starter，这个模块只负责管理依赖——比如把autoconfigure模块和其他第三方库统一引入进来。

然后，创建一个autoconfigure模块，命名方法名-spring-boot-autoconfigure。这里才是真正干活的地方。

在starter模块里引入autoconfigure模块，这样用户只需要引入starter一个起步依赖，就能连带拿到自动配置能力。

autoconfigure模块里要做的事情很明确：

• 定义一个自动配置类，把要暴露给用户的Bean全部提前配置好。
• 定义Spring Boot的自动配置文件，路径为META-INF/spring/xxxx.imports，把自动配置类的全限定名写进去。

一旦完成这两个步骤，Spring Boot在启动时就会扫描到这个imports文件，自动把我们定义的配置类加载进去，用户直接就能用。

总结

从@EnableAutoConfiguration的底层逻辑，到自定义starter的标准步骤，这条路其实很清晰。核心就是搞清楚Spring Boot是如何通过spring.factories（新版本改用imports文件）来收集自动配置类，再配合条件注解实现按需加载。弄懂了这些，以后遇到任何需要封装通用能力的场景，都可以考虑撸一个自己的starter。系统多了，代码自然就清爽了。