Spring Boot 条件注解全解析：核心机制与使用场景

3. @ConditionalOnProperty

• 作用：根据配置文件（如 application.yml）中的属性值决定是否生效
• 典型场景：功能开关、多环境配置切换
• 示例：根据配置启用缓存功能

@Configuration
@ConditionalOnProperty(name = "app.cache.enabled", havingValue = "true")
public class CacheConfig {
    // 当 app.cache.enabled=true 时加载
}

4. @ConditionalOnWebApplication 和 @ConditionalOnNotWebApplication

• 作用：根据当前应用是否为 Web 应用决定是否生效
• 典型场景：区分 Web 环境与非 Web 环境（如批处理任务）
• 示例：仅在 Web 应用中注册 MVC 组件

@Configuration
@ConditionalOnWebApplication
public class WebMvcConfig {
    // 仅在 Web 环境中生效
}

5. @ConditionalOnExpression

• 作用：通过 SpEL 表达式组合复杂条件
• 典型场景：需要同时满足多个条件或复杂逻辑判断
• 示例：同时满足属性开关和类路径存在时生效

@Bean
@ConditionalOnExpression("${app.feature.enabled} && T(com.example.SomeClass).isAvailable()")
public FeatureBean featureBean() {
    return new FeatureBean();
}

6. @ConditionalOnResource

• 作用：检查指定资源文件是否存在
• 典型场景：根据配置文件或密钥文件的存在性加载配置
• 示例：存在 config-override.properties 时覆盖默认配置

@Configuration
@ConditionalOnResource(resources = "classpath:config-override.properties")
public class OverrideConfig {
    // 当类路径存在该文件时生效
}

7. @ConditionalOnJava

• 作用：根据当前 JVM 版本决定是否生效
• 典型场景：兼容不同 Java 版本的特性
• 示例：仅当 JVM 版本为 11 或更高时启用模块化配置

@Configuration
@ConditionalOnJava(range = ConditionalOnJava.Range.EQUAL_OR_NEWER, value = JavaVersion.ELEVEN)
public class Java11Config {
    // Java 11+ 环境下生效
}

8. @ConditionalOnSingleCandidate

• 作用：当容器中存在且只有一个指定类型的 Bean 时生效
• 典型场景：自动配置依赖特定单一 Bean 的场景
• 示例：当只有一个 DataSource 时自动配置事务管理器

@Bean
@ConditionalOnSingleCandidate(DataSource.class)
public PlatformTransactionManager transactionManager(DataSource dataSource) {
    return new DataSourceTransactionManager(dataSource);
}

三、组合使用条件注解

• 多个条件注解可组合使用，实现更精细的控制

@Configuration
@ConditionalOnClass({RedisClient.class})
@ConditionalOnProperty(name = "app.redis.enabled", matchIfMissing = true)
public class RedisAutoConfig {
    // 当 RedisClient 存在且配置开启（或未配置）时生效
}

四、条件注解的底层原理

Spring Boot 在启动时，通过条件注解解析器（如 ConditionEvaluator）扫描所有配置类，结合以下步骤实现条件装配

1. 条件收集：解析配置类上的条件注解，生成对应的 Condition 实例
2. 条件匹配：调用 matches() 方法，结合类路径、Bean 容器状态、环境变量等进行判断
3. 动态注册：仅注册满足条件的 Bean，未满足的配置类会被跳过

总结

Spring Boot 的条件注解为开发者提供了强大的动态配置能力，理解其原理和适用场景是构建灵活、可扩展应用的关键。通过合理组合这些注解，可以实现'智能'的自动配置逻辑，同时避免冗余代码。实际开发中，建议结合 Spring Boot 的自动配置源码（如 spring-boot-autoconfigure 模块）深入学习。