跳到主要内容

ConditionalOnMissingBean的作用

一、背景介绍​

在 Spring Boot 的自动配置机制中，通常需要根据条件决定是否创建某个 Bean。@ConditionalOnMissingBean 就是为此目的而设计的条件注解。其主要作用是：

  • 条件装配：只有当 Spring 容器中不存在指定类型或名称的 Bean 时，才会创建被注解的方法或类中的 Bean。
  • 默认配置与用户覆盖：自动配置中常常提供默认的 Bean 定义，但允许用户自行定义并覆盖默认配置。@ConditionalOnMissingBean 就能检测到用户是否已经定义了相关 Bean，如果已定义，则不会再加载默认配置。

通过这种机制，Spring Boot 能够在保证提供合理默认配置的同时，又能让开发者轻松地进行个性化定制。

二、工作原理​

@ConditionalOnMissingBean 实际上是一个组合条件注解，它背后依赖于 Spring 的条件注解机制（Conditional）。当 Spring 容器在启动时扫描配置类时，会判断是否满足条件：

  • 检查 Bean 是否存在：根据指定的类型（value 或 type 属性）或者名称（name 属性）查找容器中是否已存在相关 Bean。
  • 判断条件：如果不存在，则条件满足，当前配置类或 Bean 定义将被加载；如果存在，则跳过当前 Bean 的创建。

这种设计让 Spring Boot 的自动配置能够非常灵活，既能提供开箱即用的默认行为，又能方便用户根据实际需要进行自定义。

三、使用场景及举例说明​

1. 自动配置类中的默认 Bean​

在很多 Spring Boot Starter 中，会包含自动配置类。假设我们有一个服务接口 MyService，框架提供了一个默认实现，但允许用户通过自定义 Bean 来覆盖默认行为：

@Configuration
public class MyServiceAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean(MyService.class)
    public MyService defaultMyService() {
        return new DefaultMyServiceImpl();
    }
}

付费内容提示

该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容
8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向
AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点
文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

完整项目实战资料

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

8 套项目
  • 01Nexus Agent AI 智能体
  • 02Nexus Agent Pro 完全版
  • 03黑马点评Plus
  • 04大麦
  • 05大麦Pro
  • 06大麦AI
  • 07流量切换
  • 08数据中台

加入后还能获得

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。

  • 1 对 1 解答项目和技术问题都可以提问
  • 针对性补充没有讲清楚的内容会继续补充
  • 面试与简历指导梳理回答技巧和项目亮点
  • 中间件云环境项目依赖可以直接接入使用
  • 面试后复盘被问住的问题可以继续交流
  • 远程问题解决项目启动问题可协助排查
知识星球二维码

扫码进入知识星球

  1. 打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球
  2. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠