多候选Bean注入优先级配置：按条件选择Bean并设置降级逻辑

方案一：全局优先级自动降级 #

这种方案适用于全局范围内，只要Bean B存在就优先用B，Bean C存在就优先用C（需避免B/C同时存在），都不存在则用Bean A。

1. 定义接口及三个Bean实现：
   • Bean A作为默认实现，无需额外优先级注解：

     @Component
     public class BeanA implements SomeCommonInterface {
         @Override
         public void doSomething() {
             // 默认降级逻辑
         }
     }
     

   • Bean B满足条件时创建，并标记为@Primary（优先被注入），同时确保B存在时C不会被创建：

     @Component
     @ConditionalOnProperty(name = "feature.b.enabled", havingValue = "true")
     @ConditionalOnMissingBean(type = "BeanC")
     @Primary
     public class BeanB implements SomeCommonInterface {
         @Override
         public void doSomething() {
             // Bean B专属逻辑
         }
     }
     

   • Bean C满足条件时创建，同样标记为@Primary，且仅在B不存在时生效：

     @Component
     @ConditionalOnProperty(name = "feature.c.enabled", havingValue = "true")
     @ConditionalOnMissingBean(type = "BeanB")
     @Primary
     public class BeanC implements SomeCommonInterface {
         @Override
         public void doSomething() {
             // Bean C专属逻辑
         }
     }
     

2. 注入时直接使用接口类型即可：

   @Autowired
   public MyService(SomeCommonInterface someBean) {
       // 自动优先选择存在的B/C，否则用A
   }
   

方案二：按需选择目标Bean并降级 #

如果需要在不同业务场景分别指定优先注入B或C，可结合Optional和@Qualifier实现灵活降级：

1. 三个Bean的定义（无需@Primary，保留原有的@ConditionalOnProperty）：

   @Component
   public class BeanA implements SomeCommonInterface { /* 降级逻辑 */ }
   
   @Component
   @ConditionalOnProperty(name = "feature.b.enabled", havingValue = "true")
   public class BeanB implements SomeCommonInterface { /* B的逻辑 */ }
   
   @Component
   @ConditionalOnProperty(name = "feature.c.enabled", havingValue = "true")
   public class BeanC implements SomeCommonInterface { /* C的逻辑 */ }
   

2. 在需要优先用B的场景中注入：

   @Service
   public class BPriorityService {
       private final SomeCommonInterface someBean;
   
       @Autowired
       public BPriorityService(@Qualifier("beanB") Optional<SomeCommonInterface> beanBOptional,
                               BeanA defaultBean) {
           this.someBean = beanBOptional.orElse(defaultBean);
       }
   }
   

3. 在需要优先用C的场景中注入：

   @Service
   public class CPriorityService {
       private final SomeCommonInterface someBean;
   
       @Autowired
       public CPriorityService(@Qualifier("beanC") Optional<SomeCommonInterface> beanCOptional,
                               BeanA defaultBean) {
           this.someBean = beanCOptional.orElse(defaultBean);
       }
   }
   

注意事项 #

• 方案一中要确保B和C的条件互斥，或者通过@ConditionalOnMissingBean避免同时出现多个@PrimaryBean，否则会触发Spring的Bean冲突异常。
• 方案二中的@Qualifier参数对应Bean的默认名称（类名首字母小写，如BeanB对应beanB），也可以通过@Component("customName")自定义Bean名称。

内容的提问来源于stack exchange，提问作者Fábio