同一类型混用@ConditionalOnMissingBean与@ConditionalOnBean的异常问题

我来帮你拆解下这个问题：当com.example.Api Bean存在时，你定义的两个ApiManager @Bean方法居然都没加载，导致ServiceImpl找不到依赖的ApiManager Bean，这确实挺让人困惑的。

先看你的报错信息：两个方法未加载的原因都是@ConditionalOnMissingBean找到了api Bean——这和你第二个方法标注的@ConditionalOnBean完全矛盾。大概率是两个@Bean方法同名导致Spring解析Bean定义时出现了逻辑混乱。

核心问题：同名Bean定义的冲突 #

你两个@Bean方法的名称都是apiManager，Spring默认会把方法名作为Bean的唯一标识。当Spring处理配置类时，会把这两个方法视为同一个Bean的不同候选定义，这时候条件判断的逻辑会被打乱：即使第二个方法的@ConditionalOnBean条件满足，也可能因为第一个方法的条件不满足而被直接跳过。

解决方案1：给Bean指定不同名称并标记主Bean #

修改两个@Bean方法，给它们起不同的名称，同时给有Api依赖的Bean标记@Primary，确保Spring优先注入它：

// 默认实现：当没有Api Bean时创建
@Bean("defaultApiManager")
@ConditionalOnMissingBean(type = {"com.example.Api"})
public ApiManager defaultApiManager() {
    return new ApiManager() {
        public Result getValue(Request request) {
            throw new UnsupportedOperationException("Api not provided.");
        }
        public Result setValue(Request request) {
            throw new UnsupportedOperationException("Api not provided.");
        }
    };
}

// 真实实现：当Api Bean存在时创建，标记为主Bean
@Bean("apiManager")
@Primary
@ConditionalOnBean(type = {"com.example.Api"})
public ApiManager apiManager(Api api) {
    return new ApiManagerImpl(api);
}

这样，当Api存在时，apiManager Bean会被创建并作为优先注入的实例；当Api不存在时，defaultApiManager会自动补位。

解决方案2：用单个@Bean方法统一处理两种场景 #

如果觉得两个@Bean方法太繁琐，可以直接在一个方法里通过ApplicationContext判断Api是否存在，返回对应的实例：

@Bean
public ApiManager apiManager(ApplicationContext context) {
    Optional<Api> apiOptional = Optional.ofNullable(context.getBean(Api.class));
    return apiOptional.map(ApiManagerImpl::new).orElseGet(() -> new ApiManager() {
        public Result getValue(Request request) {
            throw new UnsupportedOperationException("Api not provided.");
        }
        public Result setValue(Request request) {
            throw new UnsupportedOperationException("Api not provided.");
        }
    });
}

这种方式不需要依赖条件注解，直接通过上下文判断Bean存在性，逻辑更清晰。

额外提示 #

• 如果坚持用条件注解，记得把@ConditionalOnBean的搜索策略改为SearchStrategy.ALL（默认是CURRENT，只搜索当前配置类内的Bean），避免因为Api在其他配置类中定义而导致条件判断失效：

  @Bean
  @ConditionalOnBean(type = "com.example.Api", search = SearchStrategy.ALL)
  public ApiManager apiManager(Api api) {
      return new ApiManagerImpl(api);
  }
  

• 尽量用UnsupportedOperationException这类运行时异常代替检查型异常，避免额外的throws声明或try-catch包裹。

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