Spring Cloud OpenFeign如何通过纯注解方式激活断路器

根据官方文档说明，激活OpenFeign断路器默认需要在配置文件添加feign.circuitbreaker.enabled=true配置项。该配置方式可正常运行，但需要实现仅通过注解完成断路器激活、无需额外配置文件或构造器注入逻辑的方案。

已尝试的无效方案 #

• 第一步引入Resilience4j断路器依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
</dependency>

• 第二步自定义组合注解封装@EnableFeignClients：

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@EnableFeignClients
public @interface EnableFeign {
}

• 第三步编写配置类，在构造器中设置系统属性开启断路器：

@Configuration
@EnableFeign
public class FeignConfiguration {
    public FeignConfiguration() {
        Properties properties = System.getProperties();
        properties.setProperty("feign.circuitbreaker.enabled", "true");
    }
}

失效表现与原因 #

该方案冷启动时抛出空指针异常：

Cannot invoke "org.springframework.cloud.openfeign.CircuitBreakerNameResolver.resolveCircuitBreakerName(String, feign.Target, java.lang.reflect.Method)" because "this.circuitBreakerNameResolver" is null

仅在IntelliJ IDEA执行热重载后，系统属性已持久化到运行环境，功能才能正常运行，不符合预期。
核心原因是系统属性设置时机晚于@EnableFeignClients的初始化阶段：配置类构造器执行时，Feign相关的自动装配已经完成了属性读取，默认断路器为关闭状态，因此不会注入CircuitBreakerNameResolver实例。

可行实现方案 #

通过自定义ImportBeanDefinitionRegistrar在容器初始化极早期注入配置属性即可，不需要写构造器逻辑，纯注解就能实现需求。

具体实现步骤 #

1. 新增配置注册器，在Bean定义注册阶段就把断路器开关属性注入Spring环境，该执行时机远早于Feign自动装配：

import org.springframework.context.EnvironmentAware;
import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.Environment;
import org.springframework.core.env.MapPropertySource;
import org.springframework.core.type.AnnotationMetadata;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import java.util.Map;

public class FeignCircuitBreakerConfigRegistrar implements ImportBeanDefinitionRegistrar, EnvironmentAware {
    private ConfigurableEnvironment environment;

    @Override
    public void setEnvironment(Environment environment) {
        if (environment instanceof ConfigurableEnvironment ce) {
            this.environment = ce;
        }
    }

    @Override
    public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
        // 将断路器开启配置放到最高优先级属性源，避免被默认配置覆盖
        Map<String, Object> feignConfig = Map.of("feign.circuitbreaker.enabled", Boolean.TRUE);
        environment.getPropertySources().addFirst(new MapPropertySource("customFeignCircuitBreakerConfig", feignConfig));
    }
}

2. 修改自定义@EnableFeign组合注解，导入上述注册器：

import org.springframework.cloud.openfeign.EnableFeignClients;
import org.springframework.context.annotation.Import;
import java.lang.annotation.*;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@EnableFeignClients
@Import(FeignCircuitBreakerConfigRegistrar.class)
public @interface EnableFeign {
}

3. 精简原FeignConfiguration类，删除构造器内设置系统属性的冗余逻辑：

import org.springframework.context.annotation.Configuration;

@Configuration
@EnableFeign
public class FeignConfiguration {
    // 无需任何额外初始化代码
}

方案说明 #

ImportBeanDefinitionRegistrar的逻辑执行于Bean实例化之前的Bean定义注册阶段，此时注入的配置属性可以被Feign断路器的自动配置类正常读取，且最高优先级的属性源设置不会被其他配置的默认值覆盖，项目冷启动时就会正常初始化断路器相关组件，不会出现空指针异常，完全满足纯注解开启断路器的需求。

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