如何正确配置指定Spring要选用的Bean实现类？

适配Java 11 + Spring Boot 2.2.6.RELEASE技术栈，最优落地方案步骤如下：

• 先给两个Service实现类指定明确的Bean名，不要依赖Spring默认生成的类名首字母小写的默认Bean名，避免后续配置值和默认Bean名不匹配
  代码示例：

  // 实现类A
  @Service("serviceA")
  public class ServiceImpA implements Service {
      // 业务逻辑实现
  }
  
  // 实现类B
  @Service("serviceB")
  public class ServiceImpB implements Service {
      // 业务逻辑实现
  }
  

• 在application.yml里新增自定义配置项，配置值直接对应上面定义的Bean名，后续切换实现只需要改这个配置值就行：

  app:
    service:
      active-bean: serviceA # 改成serviceB就会自动切换到ServiceImpB
  

• 注入Service的时候，把之前硬编码在@Qualifier里的固定值，换成读取yml配置的占位符即可，Spring Boot 2.2.6默认就支持@Qualifier参数里的占位符解析，不需要额外写配置：
  代码示例（Spring 2.x 推荐的构造器注入写法）：

  @Service
  public class OrderBusinessService {
      private final Service commonService;
  
      public OrderBusinessService(
          @Qualifier("${app.service.active-bean}") Service commonService
      ) {
          this.commonService = commonService;
      }
  }
  

方案优势 #

• 完全复用Spring原生的@Qualifier匹配逻辑，不需要额外搞条件装配、自定义Bean工厂这类复杂逻辑，代码侵入性极低
• 配置和代码完全解耦，切换实现类只需要改yml配置重启服务，不用动任何业务Java代码
• 对当前使用的Spring Boot 2.2.6.RELEASE版本零适配成本，不需要升级依赖、不需要手动注册占位符解析器
• 异常提示清晰：如果yml里写的Bean名不存在，Spring启动的时候就会直接抛出明确的Bean创建失败异常，不用等到运行时才出问题

注意避坑 #

• 两个实现类的Bean名要和yml配置的可选值严格对应，别出现拼写不一致的低级错误，否则会报NoSuchBeanDefinitionException
• 不要在这两个实现类上随便加@Primary注解，否则会和@Qualifier的指定优先级冲突，导致注入逻辑不符合预期
• 哪怕是用字段注入的方式写@Autowired，只要@Qualifier里带相同的占位符，都能正常读取yml配置，不需要额外调整写法

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