Spring Boot中如何优雅地条件选择接口实现类

方案1：用Spring的ObjectProvider做延迟查找 #

Spring自带的ObjectProvider专门用来处理可选依赖，不用同时注入两个实例，直接按需查找优先级高的实现：

@Service
public class YourService {
    private final YourInterface yourBean;

    public YourService(ObjectProvider<YourInterface> provider) {
        // 先找IMP2，找不到就 fallback 到 IMP1
        this.yourBean = provider.getIfAvailable(() -> provider.getBean("IMP1", YourInterface.class));
    }
}

如果你的bean名称和@Qualifier的值一致，直接用名称拿就行；要是需要通过@Qualifier过滤，也可以用流处理精准匹配：

this.yourBean = provider.stream()
    .filter(bean -> {
        Qualifier qualifier = bean.getClass().getAnnotation(Qualifier.class);
        return qualifier != null && "IMP2".equals(qualifier.value());
    })
    .findFirst()
    .orElseGet(() -> provider.getBean("IMP1", YourInterface.class));

方案2：封装通用Bean选择器 #

如果多个接口都要这套逻辑，别重复写判断，封装个工具类复用：

@Component
public class BeanSelector {
    private final BeanFactory beanFactory;

    public BeanSelector(BeanFactory beanFactory) {
        this.beanFactory = beanFactory;
    }

    public <T> T pickPrimaryBean(Class<T> type, String primaryQualifier, String fallbackQualifier) {
        try {
            return beanFactory.getBean(primaryQualifier, type);
        } catch (NoSuchBeanDefinitionException e) {
            return beanFactory.getBean(fallbackQualifier, type);
        }
    }
}

用的时候直接注入选择器：

@Service
public class YourService {
    private final YourInterface yourBean;

    public YourService(BeanSelector selector) {
        this.yourBean = selector.pickPrimaryBean(YourInterface.class, "IMP2", "IMP1");
    }
}

方案3：结合@Conditional和@Primary自动切换 #

如果IMP2的加载是有条件的（比如靠配置开关控制），可以给IMP2加@Conditional，同时给IMP1标记@Primary：

// IMP2：满足条件才注册到容器
@Component
@Qualifier("IMP2")
@Conditional(YourCondition.class)
public class Impl2 implements YourInterface {
    // ...
}

// IMP1：默认实现，标记为Primary
@Component
@Qualifier("IMP1")
@Primary
public class Impl1 implements YourInterface {
    // ...
}

这时候直接注入接口就行：Spring会优先用存在的IMP2；如果IMP2没加载，就自动用标记了@Primary的IMP1，完全不用自己写判断：

@Service
public class YourService {
    private final YourInterface yourBean;

    // 直接注入，Spring自动处理优先级
    public YourService(YourInterface yourBean) {
        this.yourBean = yourBean;
    }
}

这个方案适合IMP2的存在是可配置的场景，代码最简洁。

方案4：自定义Qualifier和候选解析器（进阶） #

如果全项目所有接口都要遵循“IMP2优先、IMP1兜底”的规则，可以自定义一个注解，比如@PriorityQualifier，再写个AutowireCandidateResolver来实现底层的优先级逻辑。不过这个方式复杂度高，一般只有全局统一规则时才需要用。

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