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

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

回顧：Spring 條件裝配的基礎(chǔ)

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

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

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

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

上面的代碼表示：當(dāng)配置文件中 app.feature.enabled=true 時(shí)，才裝配該 Bean。

Spring Boot 3.4 中的增強(qiáng)點(diǎn)

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

支持條件表達(dá)式拼接

Spring Boot 3.4 引入了 基于 SpEL 表達(dá)式的條件判斷擴(kuò)展，支持在單個(gè)注解中拼接多個(gè)條件表達(dá)式，邏輯更加清晰簡(jiǎn)潔。

示例：

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

優(yōu)點(diǎn)：

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

支持自定義條件鏈組合

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

示例：自定義復(fù)合 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"));
    }
}

注冊(cè)方式：

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

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

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

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

實(shí)例場(chǎng)景：根據(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();
    }
}

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

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

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

最佳實(shí)踐與總結(jié)

建議做法：

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

結(jié)語

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

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

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