Spring Boot 3.4 條件裝配增強(qiáng)詳解：更強(qiáng)大的 @Conditional* 組合表達(dá)能力
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í)開(kāi)發(fā)中更好地落地使用。
回顧：Spring 條件裝配的基礎(chǔ)
Spring Framework 提供了一組 @Conditional* 注解，用于在滿(mǎn)足特定條件時(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 接口的組合使用能力，可通過(guò) 復(fù)合條件類(lèi) 實(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è)“組合條件類(lèi)”實(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ò)配置開(kāi)關(guān)來(lái)動(dòng)態(tài)控制功能模塊的加載，而無(wú)需修改代碼邏輯或切換 Spring Profiles。
最佳實(shí)踐與總結(jié)
建議做法：
- 使用 @ConditionalOnProperty 控制可選模塊；
- 使用 @ConditionalOnExpression 實(shí)現(xiàn)復(fù)雜邏輯組合；
- 將多個(gè)判斷封裝為自定義 Condition，提高代碼復(fù)用性；
- 模塊化配置 + 自動(dòng)裝配機(jī)制搭配使用；
- 配合 @Import 動(dòng)態(tài)引入模塊配置類(lèi)。
結(jié)語(yǔ)
Spring Boot 3.4 的條件裝配增強(qiáng)，讓微服務(wù)架構(gòu)中的模塊化開(kāi)發(fā)變得更靈活、配置驅(qū)動(dòng)更強(qiáng)、動(dòng)態(tài)裝配更輕松。在實(shí)際應(yīng)用中，它可以極大提升系統(tǒng)的擴(kuò)展能力與靈活性，特別適用于：
- 多模塊組件開(kāi)關(guān)控制；
- 多環(huán)境差異化配置；
- 插件式架構(gòu)中模塊注入；
- SaaS 系統(tǒng)租戶(hù)隔離邏輯。
掌握這些新特性，將幫助你構(gòu)建更加現(xiàn)代、模塊化、可插拔的 Spring 應(yīng)用體系。
