读取完毕后Selector 把这些类当作“候选清单”，交给过滤器逐一验收。

每个候选类上可Neng会贴上一堆 @Conditional 派生注解，例如：

@ConditionalOnClass —— 检查 classpath 中是否存在指定类型；

@ConditionalOnMissingBean —— 确认容器里没有同类型 Bean；

@ConditionalOnProperty —— kan application.yml 中对应属性是否满足预设值。

过滤过程大致如下：

protected AutoConfigurationEntry getAutoConfigurationEntry(
        AnnotationMetadata metadata, AnnotationAttributes attributes) {
    List exclusions = getExclusions;
    List candidates = getCandidateConfigurations;
    candidates = removeDuplicates;
    exclusions.forEach;
    // 真正的过滤点
    candidates = getConfigurationClassFilter.filter;
    fireAutoConfigurationImportEvents;
    return new AutoConfigurationEntry;
}

这里的 .filter 实际上会遍历所有Yi注册的 SpringBootCondition 实现，每个实现负责检查一种特定的 @Conditional 注解。Ru果任何一次检查返回 false，这个候选就会被剔除。

// com.example.sms.autoconfigure.SmsProperties
@ConfigurationProperties
public class SmsProperties {
    private String accessKey;
    private String secretKey;
    private String endpoint = "https://sms.aliyuncs.com";
    // getter & setter 略
}

// com.example.sms.autoconfigure.SmsAutoConfiguration
@AutoConfiguration   // Spring Boot 3.x 推荐写法
@ConditionalOnClass
@EnableConfigurationProperties
public class SmsAutoConfiguration {
   @Bean
   @ConditionalOnMissingBean   // 用户自己声明了则不走这里
   public SmsClient smsClient {
       SmsClient client = new SmsClient;
       client.setAccessKey);
       client.setSecretKey);
       client.setEndpoint);
       return client;
   }
}

META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 内容只有一行：

com.example.sms.autoconfigure.SmsAutoConfiguration

a) 在 *autoconfigure* 模块中放置上述代码和资源文件； b) 在 *starter* 模块里仅声明对 *autoconfigure* 的 Maven 依赖； c) 使用方只需要在自己的 pom 中加入：

   com.example
   sms-spring-boot-starter

随后在 application.yml 里添加几行配置信息即可使用：

sms:
  access-key: yourKey
  secret-key: yourSecret
  endpoint: https://sms.aliyuncs.com

A) 必须在 Classpath Neng找到 {@link SmsClient}； B) 容器中不存在同类型 Bean； C) 配置属性满足前置要求。 只要其中任意一步挂掉，这套自动化就会悄无声息地退出。

-‑debug 参数： 启动时加上 -‑debug=true, 控制台会打印 “CONDITIONS EVALUATION REPORT”。此报告分为 Positive matches 与 Negative matches，两栏清晰展示哪些 AutoConfig 被采纳、哪些被过滤以及原因。

@SpringBootApplication

spring:
  autoconfigure:
     exclude:
       - org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
       - org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

@SpringBootApplication
b) 名称排除方式 (`excludeName` 参数）  
c) YML 配置方式 `spring.autoconfigure.exclude` 列表。  
以上三种任选其一即可安全关闭对应模块。



温馨提醒 🚀 : 
Ru果本文让你眼前一亮，请不要吝啬点赞与关注！你的每一次点击dou是我继续深耕技术博客的动力源泉~ 🙏
geng多技术干货请访问我的个人站点 


© 2026 春风技术部 | 保留所有权利，仅用于学习交流。