@Conditional 是 Spring 条件化装配核心注解，通过实现 Condition 接口的 matches() 方法决定 Bean 是否注册；Spring Boot 提供 @ConditionalOnClass、@ConditionalOnMissingBean 等内置注解简化使用。
@Conditional 是 Spring 提供的条件化装配核心注解，它允许你根据自定义逻辑决定某个 Bean 是否被注册到 Spring 容器中。它的本质是：只有当指定的条件满足时，对应的类、方法或配置才生效。
理解 Conditional 的工作原理
Spring 在启动时会扫描所有 @Configuration 类和带 @Bean 的方法，并检查它们是否标注了 @Conditional。如果标注了，Spring 就会调用该注解关联的 Condition 实现类的 matches() 方法 —— 返回 true 才装配，false 则跳过。
你需要自己实现 org.springframework.context.annotation.Condition 接口，重写 matches(ConditionContext context, AnnotatedTypeMetadata metadata) 方法，在其中编写判断逻辑（比如检查环境变量、类路径是否存在、某个 Bean 是否已存在等）。
常用内置 Conditional 注解（更推荐直接使用）
Spring Boot 已为你封装好一批高频场景的条件注解，基本无需手写 Condition：
立即学习“Java免费学习笔记（深入）”；
-
@ConditionalOnProperty：根据配置属性值决定是否装配。例如：
@ConditionalOnProperty(name = "feature.enabled", havingValue = "true") -
@ConditionalOnClass：当类路径下存在指定类时才装配。例如：
@ConditionalOnClass(DataSource.class) - @ConditionalOnMissingBean：当容器中**没有**指定类型的 Bean 时才装配。常用于自动配置的兜底逻辑。
-
@ConditionalOnExpression：支持 SpEL 表达式，灵活但慎用（可读性差）。例如：
@ConditionalOnExpression("#{systemProperties['os.name'].toLowerCase().contains('win')}") - @ConditionalOnWebApplication / @ConditionalOnNotWebApplication：区分是否为 Web 环境。
手写自定义 Condition 的典型步骤
当你有特殊判断逻辑（如检查数据库类型、读取外部配置文件、校验许可证状态），可以自定义：
- 创建一个类实现
Condition接口，重写matches方法 - 在
matches中通过ConditionContext获取Environment、BeanFactory、ClassLoader等上下文信息 - 通过
AnnotatedTypeMetadata获取当前注解的属性（如自定义注解的 value 值） - 在目标 Bean 或配置类上使用
@Conditional(YourCustomCondition.class)
示例：只在测试环境下且存在 H2 驱动时装配内存数据库配置：
public class H2AvailableAndTestProfileCondition implements Condition {@Override
public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
String[] activeProfiles = context.getEnvironment().getActiveProfiles();
boolean isTest = Arrays.asList(activeProfiles).contains("test");
boolean hasH2 = context.getClassLoader().getResource("org/h2/Driver.class") != null;
return isTest && hasH2;
}
}
组合多个条件：用 @Conditional + 自定义复合逻辑
Spring 不支持直接叠加多个 @Conditional（后声明的会覆盖前一个），但你可以：
- 在一个
Condition的matches()方法里写多个判断（推荐） - 用
@Conditional引用一个“组合条件类”，内部聚合多个子条件并用与/或逻辑连接 - 配合
@Profile使用（它是基于环境的条件，和@Conditional协同无冲突）
注意：@Profile("dev") 本质上就是 @Conditional(ProfileCondition.class) 的快捷写法。
