当前位置：首页 > news >正文

@Profile, @Conditional, @ConditionalOnMissingBean, @ConditionalOnClass

news 来源：原创 2025/6/14 7:52:40

[Q&A] @Profile 引入背景
随着 Spring 应用在不同环境（开发、测试、生产）中部署的需求增加，配置文件的切换变得频繁。原有的方式需要手动修改配置或使用多个配置文件，维护成本高。@Profile 的出现使得开发者可以基于当前激活的 profile（如 dev、test、prod）来决定是否加载某个 Bean 或配置类。

[Q&A] @Conditional 引入背景
@Profile 虽然解决了环境差异问题，但无法满足更复杂的条件判断需求。@Conditional 提供了一个通用的条件化注册机制，允许开发者通过实现 Condition 接口自定义条件逻辑。

[Q&A] @ConditionalOnMissingBean 引入背景
Spring Boot 推出了自动配置机制，旨在减少用户手动配置。在自动装配过程中，为了避免重复创建相同类型的 Bean，引入了该注解，允许在容器中没有指定 Bean 时才进行自动创建。

[Q&A] @ConditionalOnClass 引入背景
Spring Boot 的自动配置模块中，很多配置依赖于第三方库的存在（如 Tomcat、Jackson、JPA 等）。如果项目中未引入这些依赖，自动配置类可能会因找不到类而报错。@ConditionalOnClass 的引入提供了一种优雅的方式，在类路径存在指定类时才加载相关配置，避免启动失败。

注解名称	所属模块	引入版本	作用维度	典型用途
@Profile	Spring Framework	Spring 3.1 (2011)	环境配置	根据环境加载不同配置,开发 / 测试 / 生产环境切换数据源
@Conditional	Spring Framework	Spring 4.0 (2013)	自定义条件	动态控制 Bean 加载
@ConditionalOnMissingBean	Spring Boot	Spring Boot 1.0 (2014)	容器状态	是否存在同类型 Bean,防止重复注册默认 Bean
@ConditionalOnClass	Spring Boot	Spring Boot 1.0 (2014)	类路径检查	类路径是否存在指定类,判断依赖是否存在以决定是否启用配置

注解名称	所属模块	引入版本	是否推荐使用	是否淘汰及替代建议
@ConditionalOnExpression	spring-context-support / spring-boot-autoconfigure	Spring 3.1 (2011) / Boot 1.0	✔️ 是（灵活但复杂）	❌ 否
@Conditional	spring-context	Spring 4.0 (2013)	✔️ 是	❌ 否
@ConditionalOnMissingBean	spring-boot-autoconfigure	Spring Boot 1.0 (2014)	✔️ 是	❌ 否
@ConditionalOnClass	spring-boot-autoconfigure	Spring Boot 1.0 (2014)	✔️ 是	❌ 否
@ConditionalOnBean	spring-boot-autoconfigure	Spring Boot 1.0 (2014)	✔️ 是	❌ 否
@ConditionalOnProperty	spring-boot-autoconfigure	Spring Boot 1.0 (2014)	✔️ 是	❌ 否
@ConditionalOnResource	spring-boot-autoconfigure	Spring Boot 1.0 (2014)	⚠️ 不常用	⚠️ 推荐替代: `@ConditionalOnResourceCondition`