Spring Boot中@Qualifier注解失效：CircuitBreakerConfig多Bean注入报错

问题原因 #

核心问题在于：通过@Bean方法创建CustomCircuitBreakerFactory时，Spring优先解析该方法参数的注入规则，而非CustomCircuitBreakerFactory构造方法上的@Qualifier注解。如果@Bean方法的参数未指定限定符，Spring会尝试注入所有匹配CircuitBreakerConfig类型的Bean，导致因找到两个实例而报错。

解决方案 #

1. 在@Bean方法的参数上直接添加@Qualifier #

这是最直接的修复方式，针对每个API对应的CustomCircuitBreakerFactory实例，在创建Bean的方法参数上指定对应的限定符：

第一步：确认CircuitBreakerConfig的Bean定义（确保@Qualifier值与方法名/Bean名称一致）

@Configuration
public class ApiFacadeApplication {
    @Bean
    @Qualifier("api1CircuitBreakerConfig")
    public CircuitBreakerConfig api1CircuitBreakerConfig() {
        return CircuitBreakerConfig.custom()
                .failureRateThreshold(50)
                .waitDurationInOpenState(Duration.ofSeconds(10))
                .build();
    }

    @Bean
    @Qualifier("api2CircuitBreakerConfig")
    public CircuitBreakerConfig api2CircuitBreakerConfig() {
        return CircuitBreakerConfig.custom()
                .failureRateThreshold(30)
                .waitDurationInOpenState(Duration.ofSeconds(5))
                .build();
    }
}

第二步：在创建CustomCircuitBreakerFactory的@Bean方法参数上添加@Qualifier

如果需要为两个API分别创建独立的断路器工厂，要为每个工厂Bean指定唯一名称和对应的配置：

@Configuration
public class ApiApplication {
    // 对应API1的断路器工厂
    @Bean("api1CircuitBreakerFactory")
    public CustomCircuitBreakerFactory api1CircuitBreakerFactory(
            @Qualifier("api1CircuitBreakerConfig") CircuitBreakerConfig config) {
        return new CustomCircuitBreakerFactory(config);
    }

    // 对应API2的断路器工厂
    @Bean("api2CircuitBreakerFactory")
    public CustomCircuitBreakerFactory api2CircuitBreakerFactory(
            @Qualifier("api2CircuitBreakerConfig") CircuitBreakerConfig config) {
        return new CustomCircuitBreakerFactory(config);
    }
}

2. 若CustomCircuitBreakerFactory使用@Component注解 #

如果你的CustomCircuitBreakerFactory是通过@Component自动扫描创建的，需要将@Qualifier直接添加到构造方法的参数上：

@Component
@Qualifier("api1CircuitBreakerFactory")
public class CustomCircuitBreakerFactory {
    private final CircuitBreakerConfig config;

    // @Qualifier必须加在构造方法的参数上
    public CustomCircuitBreakerFactory(@Qualifier("api1CircuitBreakerConfig") CircuitBreakerConfig config) {
        this.config = config;
    }
}

这种方式适合单实例场景，若需要多实例，推荐使用@Bean方法的方式更灵活。

关键注意事项 #

• 确保@Qualifier的value与目标Bean的名称完全匹配（默认@Bean方法的方法名就是Bean名称）。
• 如果只需要一个CustomCircuitBreakerFactory实例，可以将其中一个CircuitBreakerConfig标记为@Primary，让Spring优先注入该Bean，但这种方式不适合需要独立配置的多API场景。

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