自动配置机制

runtao.zhong 于 2026-08-11 发布

Spring Boot Starter 核心运行流程

  1. 引入自定义/官方 starter 依赖后,会自动传递导入对应的 autoconfigure 自动配置包。

  2. autoconfigure 包的资源目录下,存在固定路径文件:

    META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

    该文件内预先定义了所有需要在项目启动时加载的自动配置类全限定名。

  3. Spring Boot 核心注解 @EnableAutoConfiguration 会自动扫描并导入上述文件中声明的全部自动配置类,这些类本身标注了条件注解,会根据项目当前环境 按需加载

  4. 命名格式为 XxxAutoConfiguration 的自动配置类,会向 Spring IOC 容器中批量注册所需的功能组件,组件的属性值全部从对应的 XxxProperties 配置属性类中读取。

  5. XxxProperties 类通过 @ConfigurationProperties 注解和项目的 application.yml / application.properties 配置文件完成绑定,直接读取用户自定义的参数。