springboot的自动装配

xbgRS2026-08-15 5:15

SpringBoot 自动装配：根据条件，自动把第三方组件 / Bean 注入到 Spring 容器，不用手动写大量 XML、不用手动 @Bean，本质是 Spring 的条件注解 + SPI 扩展机制。

核心注解@EnableAutoConfiguration

@SpringBootApplication是复合注解，里面包含了@EnableAutoConfiguration，它就是自动装配的开关。

java 复制代码

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration  // ✅开启自动装配
@ComponentScan
public @interface SpringBootApplication {}

@EnableAutoConfiguration 做了两件事

1、导入AutoConfigurationImportSelector选择器（核心类）

2、这个选择器读取META‑INF/spring/org.springframework.boot.autoconfigure.imports文件（SpringBoot2.7+，旧版本是spring.factories）

自动配置类（xxxAutoConfiguration）

自动配置类就是 Java 配置类，一般长这样：

java 复制代码

@Configuration(proxyBeanMethods = false)
@ConditionalOnClass({Servlet.class, DispatcherServlet.class}) // 类存在才生效
@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET)
@EnableConfigurationProperties({WebMvcProperties.class})
public class WebMvcAutoConfiguration {
    // 内部@Bean，条件满足就注册组件到容器
}

重点：条件注解（ConditionalOnXXX）

@ConditionalOnClass：类路径存在指定类，才生效

@ConditionalOnMissingBean：容器没有这个 Bean才创建（我们自己写的 @Bean 优先级更高，可以覆盖自动装配）

@ConditionalOnProperty：配置文件有对应配置才生效

@ConditionalOnWebApplication ：web 环境才生效

自动装配流程

启动类加上@SpringBootApplication，触发@EnableAutoConfiguration
AutoConfigurationImportSelector读取配置文件，拿到一批自动配置类全类名
根据条件注解@ConditionalOnXXX过滤这些配置类
符合条件的配置类生效，执行内部@Bean方法，把组件注册进 Spring 容器
同时绑定 application 配置，给 Bean 赋值

举例：引入spring‑boot‑starter‑web

存在DispatcherServlet.class → WebMvcAutoConfiguration条件成立
自动注册视图解析器、DispatcherServlet、资源处理器等 Bean，直接 web 项目就跑起来，不用自己配置。