如何注册非自动装配候选Bean且不覆盖@ConditionalOnMissingBean标记的Bean？

问题核心 #

外部库中定义的defaultService使用了@ConditionalOnMissingBean注解，该注解默认会扫描所有同类型的Bean定义（无论autowireCandidate是否为false）。你定义的specialCaseService属于Service类型，因此会触发条件判断，导致默认的defaultService无法被创建。

可行解决方案 #

方案1：修改自定义Bean的角色，规避条件检测

Spring的BeanDefinition有一个role属性，当设置为ROLE_INFRASTRUCTURE或ROLE_SUPPORT时，不会被@ConditionalOnMissingBean这类条件注解纳入检测范围。你可以在注册自定义Bean时修改其角色：

@Bean(autowireCandidate = false)
public Service specialCaseService(Object customDependency, BeanDefinitionRegistry registry) {
    // 获取当前Bean的定义对象
    BeanDefinition beanDef = registry.getBeanDefinition("specialCaseService");
    // 设置角色为基础设施类，避免被条件注解检测
    beanDef.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
    return new DefaultService(customDependency);
}

这样，外部库的@ConditionalOnMissingBean不会识别到你的specialCaseService，默认的defaultService会正常创建。在需要使用特殊Bean的场景，你可以通过ApplicationContext.getBean("specialCaseService")手动获取。

方案2：包装自定义Bean为不同类型

将你的特殊Service包装成一个非Service类型的Bean，这样就不会触发同类型的条件检测：

// 自定义包装类
public class SpecialServiceHolder {
    private final Service service;

    public SpecialServiceHolder(Service service) {
        this.service = service;
    }

    public Service getSpecialService() {
        return service;
    }
}

// 注册包装后的Bean
@Bean(autowireCandidate = false)
public SpecialServiceHolder specialCaseServiceHolder(Object customDependency) {
    return new SpecialServiceHolder(new DefaultService(customDependency));
}

此时，Spring容器中只会检测到外部库的Service类型Bean，defaultService会正常创建。需要使用特殊Bean时，注入SpecialServiceHolder并调用getSpecialService()即可。

方案3：手动实例化特殊Bean（非Spring管理）

如果上述方案都不适用，你可以直接手动创建特殊Service实例，不通过Spring Bean注册：

// 在需要使用的地方直接创建，或者封装成工具类
public Service getSpecialCaseService(Object customDependency) {
    return new DefaultService(customDependency);
}

这种方式完全不会影响Spring容器中默认Bean的创建，适合场景简单的情况。

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