如何正确实现基于@ConditionalOnBean注解的Bean依赖链？

问题根源 #

你遇到的核心问题有两个：

1. 代码中存在注解拼写错误：@ConditionOnBean少了字母l，正确应为@ConditionalOnBean，这会导致条件判断完全失效；
2. MainConfig通过@Bean方法返回null的方式控制Bean存在性，Spring对这种方式的条件识别存在偏差，且自动配置类的加载顺序可能导致条件判断时机过早。

修复与实现方案 #

1. 修正注解与方法拼写错误

首先把所有拼写错误的注解和方法名修正：

• 将@ConditionOnBean改为@ConditionalOnBean
• 将messgageConsumer方法名改为messageConsumer（多了一个s）

2. 优化MainConfig的Bean创建逻辑

避免在@Bean方法中返回null，改用Spring标准的@Conditional注解控制Bean的创建，确保Spring能正确识别Bean是否存在：

@Configuration
@Import(MessageConsumerAutoConfig.class)
public class MainConfiguration {

   @Bean
   @Conditional(MainConfigCondition.class)
   public MainConfig mainConfig() {
      return new MainConfig();
   }

   // 自定义条件类，替代原有的返回null逻辑
   static class MainConfigCondition implements Condition {
      @Override
      public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
          boolean shouldCreate = ...; // 这里写你原来的some condition判断逻辑
          if (!shouldCreate) {
              context.getBeanFactory().getBean(Log.class).warning("Bean shouldn't be initialized");
          }
          return shouldCreate;
      }
   }
}

3. 调整自动配置类的加载顺序

给MessageConsumerAutoConfig添加@AutoConfigureAfter注解，确保它在主配置类之后加载，保证条件判断时MainConfig和MyMessageListener的状态已经确定：

@Configuration 
@AutoConfigureAfter(MainConfiguration.class)
public class MessageConsumerAutoConfig {

    @Bean
    @ConditionalOnBean(MessageListener.class)
    public MessageConsumer messageConsumer(MessageListener listener) {
        // 这里写你的listener处理逻辑
        return new MessageConsumer(listener);
    }
}

4. 保持MyMessageListener的条件配置

@Service
@ConditionalOnBean(MainConfig.class)
public class MyMessageListener implements MessageListener  {
    ...
}

最终效果 #

• 当MainConfigCondition判断为false时，MainConfig不会被注册；
• MyMessageListener的@ConditionalOnBean(MainConfig.class)会跳过自身实例化；
• MessageConsumerAutoConfig中的@ConditionalOnBean(MessageListener.class)会因为不存在MessageListener类型Bean，跳过MessageConsumer的创建。

内容的提问来源于stack exchange，提问作者Dinar_sd