SpringBoot自动配置通过条件过滤动态筛选生效类，发生在类加载前的字符串级预筛阶段，依赖spring-boot-configuration-processor生成元数据，结合@ConditionalOnClass、@ConditionalOnMissingBean及application.yml排除机制实现精准控制。
SpringBoot项目启动时，自动配置类不是全部生效，而是根据classpath是否存在特定类、容器中是否已有同类型Bean、配置文件中是否设置了某属性等实时条件动态筛选——这一步漏掉，轻则启动失败，重则Bean覆盖冲突导致功能异常。
理解条件过滤发生的阶段
条件过滤发生在自动配置类被加载进JVM之前，属于字符串级预筛。AutoConfigurationImportSelector读取META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports中的全限定类名列表后，先交给AutoConfigurationImportFilter处理，再进入@Conditional注解评估。这一步不耗反射开销，纯字符串匹配或元数据查表。
【必须在项目中引入spring-boot-configuration-processor依赖】，否则AutoConfigurationMetadata为空，自定义Filter无法获取注解元信息，match方法将失去判断依据。
用@ConditionalOnClass精准控制类路径依赖
当自动配置类依赖某个第三方库（如Hibernate）时，@ConditionalOnClass确保该类存在才激活配置。
第一步：确认目标类在当前classpath下真实可用——不是仅存在于pom.xml里，而是实际被Maven下载并加入运行时类路径。常见坑是依赖scope为test或provided，导致启动时报ClassNotFoundException却误判为条件不满足。
第二步：在自动配置类上标注@ConditionalOnClass(DataSource.class)，注意这里填的是运行时能加载的类，不是接口或抽象类（除非它们也被打包进jar）。
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
第三步：若需同时检查多个类，用数组形式：@ConditionalOnClass({JdbcTemplate.class, DataSource.class})。
用@ConditionalOnMissingBean避免Bean冲突
当你自己定义了DataSource Bean，又引入了spring-boot-starter-jdbc，SpringBoot默认会创建一个HikariDataSource。此时@ConditionalOnMissingBean起作用——它只在容器中找不到指定类型且无同名Bean时才注册自动配置的Bean。
方法一：直接指定类型
@ConditionalOnMissingBean(DataSource.class)
方法二：指定类型+名称，更严格
@ConditionalOnMissingBean(type = "javax.sql.DataSource", name = "dataSource")
注意：如果手动@Bean方法未加@Primary，而自动配置也生成同类型Bean，可能触发NoSuchBeanDefinitionException——这不是条件过滤失效，而是IoC容器无法决定注入哪一个。
通过application.yml动态开关配置
适合多环境切换，比如测试环境禁用邮件自动配置，生产环境启用。
在application.yml中写：
spring:
autoconfigure:
exclude:
- org.springframework.boot.autoconfigure.mail.MailSenderAutoConfiguration
这等价于在@SpringBootApplication中写exclude，但优势在于可配合profile使用：
spring:
profiles:
active: dev
---
spring:
profiles: dev
autoconfigure:
exclude:
- org.springframework.boot.autoconfigure.redis.RedisAutoConfiguration
自定义AutoConfigurationImportFilter高效预筛
适用于启动慢的大项目，提前排除明显无关的配置类（如所有带test字样的、或来自特定包路径的），避免后续反射和条件评估。
第一步：编写实现类
public class FastExcludeFilter implements AutoConfigurationImportFilter {
@Override
public boolean[] match(String[] autoConfigurationClasses, AutoConfigurationMetadata metadata) {
boolean[] result = new boolean[autoConfigurationClasses.length];
for (int i = 0; i
// 排除所有org.springframework.boot.autoconfigure.web开头的类
result[i] = !autoConfigurationClasses[i].startsWith("org.springframework.boot.autoconfigure.web");
}
return result;
}
}
第二步：在META-INF/spring.factories中注册（Spring Boot 2.x/3.x兼容方式）
org.springframework.boot.autoconfigure.AutoConfigurationImportFilter=com.example.FastExcludeFilter
第三步：确保该Filter类在主启动类所在模块的classpath中，否则spring.factories声明无效。
