Spring Boot 提供了強大的自動裝配機制，而 @Conditional* 系列注解正是這個體系的基石。在 Spring Boot 3.4 中，官方對這些注解能力做了進一步增強，特別是在「條件表達式拼接」、「自定義條件鏈組合」和「與配置屬性聯(lián)動裝配」方面，讓模塊級裝配邏輯變得更加靈活、精細、智能。

本文將帶你深入理解 Spring Boot 3.4 條件裝配增強的關(guān)鍵能力，配合實際示例幫助你在企業(yè)級開發(fā)中更好地落地使用。

回顧：Spring 條件裝配的基礎

Spring Framework 提供了一組 @Conditional* 注解，用于在滿足特定條件時才激活 Bean 的注冊。例如：

• @ConditionalOnProperty
• @ConditionalOnClass
• @ConditionalOnMissingBean
• @ConditionalOnExpression
• @ConditionalOnBean

這些注解在 Spring Boot 的自動配置中被大量使用，例如：

@Bean
@ConditionalOnProperty(name = "app.feature.enabled", havingValue = "true")
public MyFeatureBean myFeatureBean() {
    return new MyFeatureBean();
}

上面的代碼表示：當配置文件中 app.feature.enabled=true 時，才裝配該 Bean。

Spring Boot 3.4 中的增強點

在 3.4 版本中，Spring Boot 對條件注解提供了更多 組合能力 和 擴展能力，主要體現(xiàn)在以下三方面：

支持條件表達式拼接

Spring Boot 3.4 引入了 基于 SpEL 表達式的條件判斷擴展，支持在單個注解中拼接多個條件表達式，邏輯更加清晰簡潔。

示例：

@ConditionalOnExpression("#{environment['feature.a'] == 'true' and environment['feature.b'] != 'false'}")
@Bean
public MyAdvancedBean advancedBean() {
    return new MyAdvancedBean();
}

優(yōu)點：

• 支持 and / or / ! 等操作；
• 表達邏輯更清晰；
• 減少多注解堆疊導致的閱讀困難。

支持自定義條件鏈組合

Spring Boot 3.4 強化了 Condition 接口的組合使用能力，可通過 復合條件類 實現(xiàn)更復雜的邏輯判斷。

示例：自定義復合 Condition

public class AllFeaturesEnabledCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Environment env = context.getEnvironment();
        return "true".equals(env.getProperty("feature.a"))
            && "true".equals(env.getProperty("feature.b"))
            && "true".equals(env.getProperty("feature.c"));
    }
}

注冊方式：

@Conditional(AllFeaturesEnabledCondition.class)
@Bean
public MultiFeatureBean multiFeatureBean() {
    return new MultiFeatureBean();
}

如果你想實現(xiàn) 條件或關(guān)系（OR）、異或關(guān)系，可將多個 Condition 再封裝成一個“組合條件類”實現(xiàn)。

更好地配合原生配置做模塊裝配

Spring Boot 3.4 的另一個亮點是條件裝配可以更好地和原生配置機制聯(lián)動，例如 ConfigData、Profile、YAML 分組配置。

實例場景：根據(jù)不同模塊啟用功能子系統(tǒng)

app:
  modules:
    search: true
    recommend: false
@ConditionalOnProperty(name = "app.modules.search", havingValue = "true")
@Configuration
public class SearchModuleAutoConfiguration {
    @Bean
    public SearchService searchService() {
        return new SearchServiceImpl();
    }
}

進一步結(jié)合 @Import 機制可實現(xiàn)：

@Configuration
@Import({
    SearchModuleAutoConfiguration.class,
    RecommendModuleAutoConfiguration.class
})
public class ModuleManagerConfiguration {
}

這樣你可以通過配置開關(guān)來動態(tài)控制功能模塊的加載，而無需修改代碼邏輯或切換 Spring Profiles。

最佳實踐與總結(jié)

建議做法：

• 使用 @ConditionalOnProperty 控制可選模塊；
• 使用 @ConditionalOnExpression 實現(xiàn)復雜邏輯組合；
• 將多個判斷封裝為自定義 Condition，提高代碼復用性；
• 模塊化配置 + 自動裝配機制搭配使用；
• 配合 @Import 動態(tài)引入模塊配置類。

結(jié)語

Spring Boot 3.4 的條件裝配增強，讓微服務架構(gòu)中的模塊化開發(fā)變得更靈活、配置驅(qū)動更強、動態(tài)裝配更輕松。在實際應用中，它可以極大提升系統(tǒng)的擴展能力與靈活性，特別適用于：

• 多模塊組件開關(guān)控制；
• 多環(huán)境差異化配置；
• 插件式架構(gòu)中模塊注入；
• SaaS 系統(tǒng)租戶隔離邏輯。

掌握這些新特性，將幫助你構(gòu)建更加現(xiàn)代、模塊化、可插拔的 Spring 應用體系。