引言

  Spring Boot 的條件注解（Conditional Annotations）是自動配置（Auto-Configuration）的核心機制之一。它們允許開發(fā)者根據(jù)特定的條件動態(tài)決定是否加載某個Bean或配置類，從而實現(xiàn)靈活的“按需配置”。本文將系統(tǒng)梳理所有常用的條件注解，結(jié)合代碼示例說明其作用與使用場景。

一、條件注解的核心機制

  元注解：@Conditional作為所有條件注解的基礎，@Conditional通過實現(xiàn)Condition接口的matches()方法進行條件判斷。若條件滿足，則Bean或配置類生效；否則跳過。

示例：自定義條件類檢查JdbcTemplate是否存在

   public class JdbcTemplateCondition implements Condition {
       @Override
       public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
           return ClassUtils.isPresent("org.springframework.jdbc.core.JdbcTemplate", context.getClassLoader());
       }
   }

二、SpringBoot內(nèi)置條件注解詳解

  SpringBoot基于@Conditional擴展了以下常用注解，覆蓋了大多數(shù)自動化配置場景。

1、@ConditionalOnClass和@ConditionalOnMissingClass

• 作用：根據(jù)類路徑中是否存在指定類來決定是否生效
• 典型場景：自動配置類中檢查依賴庫是否存在
• 示例：當項目中引入 Hibernate 時，自動配置JPA相關(guān)Bean

@Configuration
@ConditionalOnClass({ DataSource.class, EntityManager.class })
public class JpaAutoConfiguration {
    // 當類路徑存在DataSource和EntityManager時生效
}

2、@ConditionalOnBean和@ConditionalOnMissingBean

• 作用：根據(jù)容器中是否存在指定Bean來決定是否生效
• 典型場景：避免重復注冊Bean，或為默認Bean提供自定義覆蓋
• 示例：當用戶未自定義DataSource時，注冊默認數(shù)據(jù)源

@Bean
@ConditionalOnMissingBean(DataSource.class)
public DataSource defaultDataSource() {
    return new HikariDataSource();
}

3、@ConditionalOnProperty

• 作用：根據(jù)配置文件（如application.yml）中的屬性值決定是否生效
• 典型場景：功能開關(guān)、多環(huán)境配置切換
• 示例：根據(jù)配置啟用緩存功能

@Configuration
@ConditionalOnProperty(name = "app.cache.enabled", havingValue = "true")
public class CacheConfig {
    // 當app.cache.enabled=true時加載
}

4、@ConditionalOnWebApplication和@ConditionalOnNotWebApplication

• 作用：根據(jù)當前應用是否為Web應用決定是否生效
• 典型場景：區(qū)分Web環(huán)境與非Web環(huán)境（如批處理任務）
• 示例：僅在Web應用中注冊MVC組件

@Configuration
@ConditionalOnWebApplication
public class WebMvcConfig {
    // 僅在Web環(huán)境中生效
}

5、@ConditionalOnExpression

• 作用：通過SpEL表達式組合復雜條件
• 典型場景：需要同時滿足多個條件或復雜邏輯判斷
• 示例：同時滿足屬性開關(guān)和類路徑存在時生效

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

6、@ConditionalOnResource

• 作用：檢查指定資源文件是否存在
• 典型場景：根據(jù)配置文件或密鑰文件的存在性加載配置
• 示例：存在config-override.properties時覆蓋默認配置

@Configuration
@ConditionalOnResource(resources = "classpath:config-override.properties")
public class OverrideConfig {
    // 當類路徑存在該文件時生效
}

7、@ConditionalOnJava

• 作用：根據(jù)當前JVM版本決定是否生效
• 典型場景：兼容不同Java版本的特性
• 示例：僅當JVM版本為11或更高時啟用模塊化配置

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

8、@ConditionalOnSingleCandidate

• 作用：當容器中存在且只有一個指定類型的Bean時生效
• 典型場景：自動配置依賴特定單一Bean的場景
• 示例：當只有一個DataSource時自動配置事務管理器

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

三、組合使用條件注解

多個條件注解可組合使用，實現(xiàn)更精細的控制

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

四、條件注解的底層原理

Spring Boot在啟動時，通過條件注解解析器（如ConditionEvaluator）掃描所有配置類，結(jié)合以下步驟實現(xiàn)條件裝配

• 條件收集：解析配置類上的條件注解，生成對應的Condition實例
• 條件匹配：調(diào)用matches()方法，結(jié)合類路徑、Bean容器狀態(tài)、環(huán)境變量等進行判斷
• 動態(tài)注冊：僅注冊滿足條件的Bean，未滿足的配置類會被跳過

總結(jié)

  Spring Boot的條件注解為開發(fā)者提供了強大的動態(tài)配置能力，理解其原理和適用場景是構(gòu)建靈活、可擴展應用的關(guān)鍵。通過合理組合這些注解，可以實現(xiàn)“智能”的自動配置邏輯，同時避免冗余代碼。實際開發(fā)中，建議結(jié)合Spring Boot的自動配置源碼（如spring-boot-autoconfigure模塊）深入學習。

到此這篇關(guān)于SpringBoot條件注解全解析：核心作用與使用場景詳解的文章就介紹到這了,更多相關(guān)SpringBoot條件注解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論