一、解释@Conditional

@Conditional的作用是：只有在满足某个条件时，才把这个 Bean 放进 Spring 容器里。

不满足条件 → 不装配
满足条件 → 才装配

你可以理解为：

if (条件满足) { 把这个 Bean 交给 Spring 管理 } else { 不要管它 }

1、例子

你有一个 Bean：

@Bean public UserService userService() { return new UserService(); }

现在你想让这个 Bean只有在某个条件成立时才生效。

加@Conditional

@Bean @Conditional(MyCondition.class) // ✅ 在某个条件成立时，才注册 public UserService userService() { return new UserService(); }

MyCondition是你写的“判定逻辑”类：

public class MyCondition implements Condition { @Override public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) { // 返回 true：装配 // 返回 false：不装配 return true; // 你可以加自己的判断逻辑 } }

2、这在什么时候特别有用？

二、现成的条件注解

Spring Boot 已经提供了很多现成的条件注解（不用自己写Condition）

2-1、最常用：@ConditionalOnProperty（做配置开关）

application.yml:

my.feature.enabled: true

配置类：

@Bean @ConditionalOnProperty(name="my.feature.enabled", havingValue="true") public UserService userService() { return new UserService(); }

改成false→ 这个 Bean 自动消失
不用改代码，只改配置，非常优雅

2-2、Spring Boot 自动配置为什么强？

因为用了大量@Conditional

Spring Boot 的自动配置 ≈ @Import(...) + 一堆 @ConditionalXxx

比如 Redis 自动配置：

@Configuration @ConditionalOnClass(RedisConnection.class) // 项目里有 Redis 依赖才生效 class RedisAutoConfiguration { }

如果你没引入 Redis 依赖 → 这整个配置类直接跳过。

这就是为什么：

“你引什么依赖，就自动开什么功能。”

小结：

@Conditional = 带条件的 @Bean
满足才装，不满足就跳过
Spring Boot 自动配置全靠它

三、@Conditional 注解添加在哪里

@Conditional不是随便加的，要加在“Spring 解析 Bean 的地方”。

@Conditional可以加在：

1. 配置类上@Configuration（控制整个配置类是否生效）

2. @Bean方法上（控制某个 Bean 是否生效）

其它地方不要加，它不会生效。

1)加在配置类上（控制一坨 Bean）

@Configuration @Conditional(MyCondition.class) // ✅ 满足条件时，这里所有 Bean 才会被注册 public class AppConfig { @Bean public UserService userService(){ return new UserService(); } @Bean public OrderService orderService(){ return new OrderService(); } }

结果：

• 如果条件成立 →UserService和OrderService都进入容器

• 如果条件不成立 →这个配置类整个不生效

适用于：开关整个功能模块

2)加在@Bean方法上（控制单个 Bean）

@Configuration public class AppConfig { @Bean @Conditional(MyCondition.class) // ✅ 只有满足条件才创建这个 Bean public UserService userService(){ return new UserService(); } }

结果：

• 满足条件 →userService注册

• 不满足 → 不注册（也就不能@Autowired）

适用于：只控制某个特定 Bean 是否装配

总结：

@Conditional 要么加在配置类 @Configuration上，要么加在@Bean 方法上。

• 控制模块级 → 配置类上
• 控制单个 bean → 方法上

四、举例讲解：@ConditionalOnBean、@ConditionalOnMissingBean

4-1、它们俩的本质区别

你可以理解为：

ConditionalOnBean = 有就装 ConditionalOnMissingBean = 没有才装

4-2.@ConditionalOnBean示例（“有依赖才启用”）

假设：

• 只有你项目里已经有 UserService

• 才允许使用 OrderService

@Configuration public class AppConfig { @Bean public UserService userService() { return new UserService(); } @Bean @ConditionalOnBean(UserService.class) // ✅ 如果容器里存在 UserService 才创建 public OrderService orderService() { return new OrderService(); } }

结果：

适用场景：

比如一个功能必须依赖另一个模块才能开启。

4-3.@ConditionalOnMissingBean示例（“没有才给你默认实现”）

Spring Boot 在自动配置里用得特别多。

比如，给你一个默认的UserService，但如果你自己已经写了，就不用它的：

@Configuration public class AppConfig { // ✅ 默认 UserService @Bean @ConditionalOnMissingBean(UserService.class) public UserService defaultUserService(){ return new UserService("默认实现"); } }

用户自己写了一个：

@Service public class UserService { public UserService() { System.out.println("这是我自己的实现"); } }

结果：

• Spring Boot 发现你自己已经实现了UserService

• 它自动跳过默认的那一个

4-4、为什么 Spring Boot 自动配置很聪明？

因为它常常写：

@Bean @ConditionalOnMissingBean public Xxx defaultXxx(){ ... }

你不写，就给你默认的
你一旦写了，直接用你的

这就解释了大家常说的：

Spring Boot 自动配置 → "约定优于配置"

"自动装配"是机制，"约定优于配置"是设计思想。它们合在一起，解决的是"重复写样板配置"的问题。

"约定"就是：框架先帮你把默认答案填好

"约定"的本质是：框架预设了一套"最常用"的默认行为。

"优于配置"的意思是：约定好的默认值，优先级高于你手动写的配置。只有当默认值不符合你的需求时，你才需要去覆盖它。

Spring Boot 用了一系列@Conditional注解来实现"约定判断"：

Table

这就是"约定"的技术实现：框架通过检查你的环境（classpath、配置、Bean 是否存在），来"猜测"你需要什么，然后自动配置。

一句话：

Spring Boot 的自动装配，就是框架根据"你引入了什么依赖"这个约定，自动帮你把最可能需要的配置做完，让你尽量少写甚至不写配置代码。

总结

@ConditionalOnBean → 有它才配我 @ConditionalOnMissingBean → 你没写我来补

• 前者做依赖判断（依赖存在才装配）

• 后者做默认兜底（避免 Bean 冲突）