Spring Boot多Feign客户端配置不同拦截器鉴权失败如何解决

1. 代码笔误：原Client2配置类的构造方法命名错误，写为public Client1(final Config2 config)，构造器名与类名不匹配，Spring无法实例化该配置类。
2. Feign配置隔离规则使用错误：@FeignClient的configuration属性指向的专属配置类不能添加@Configuration注解，一旦添加就会被Spring主上下文扫描加载，其中定义的Bean会成为全局组件，被所有Feign客户端共享，既无法实现不同客户端的配置隔离，还会导致对应Feign客户端的专属子上下文无法正确加载你定义的拦截器Bean。
3. 原自定义配置类名和Feign接口名重名，容易引发上下文扫描、依赖注入的混淆问题。

1. 编写Feign客户端专属配置类 #

注意两个核心要求：不要加@Configuration注解，修正构造方法命名错误，建议将配置类放在Feign接口所在的独立包下，避免被主应用的@ComponentScan直接扫描到。

// Client1专属配置，不添加@Configuration注解
public class Client1FeignConfig {
    private final String user;
    private final String password;

    public Client1FeignConfig(Config1 config) {
        this.user = config.getUser();
        this.password = config.getPassword();
    }

    @Bean
    public BasicAuthRequestInterceptor client1BasicAuth() {
        return new BasicAuthRequestInterceptor(user, password);
    }
}

// Client2专属配置，不添加@Configuration注解
public class Client2FeignConfig {
    private final String user;
    private final String password;

    // 修正原代码构造器名写错的问题
    public Client2FeignConfig(Config2 config) {
        this.user = config.getUser();
        this.password = config.getPassword();
    }

    @Bean
    public BasicAuthRequestInterceptor client2BasicAuth() {
        return new BasicAuthRequestInterceptor(user, password);
    }
}

2. 修正Feign客户端的配置关联 #

将@FeignClient注解的configuration属性指向上述两个专属配置类即可：

@FeignClient(
    name = "client1",
    url = "${url1}",
    configuration = Client1FeignConfig.class
)
public interface Client1 {
    @PostMapping(
        path = "...",
        consumes = MediaType.APPLICATION_JSON_VALUE,
        produces = MediaType.APPLICATION_JSON_VALUE)
    JsonNode doThing(@RequestBody JsonNode thing);
}

@FeignClient(
    name = "client2",
    url = "${url2}",
    configuration = Client2FeignConfig.class
)
public interface Client2 {
    @PostMapping(
        path = "...",
        consumes = MediaType.APPLICATION_JSON_VALUE,
        produces = MediaType.APPLICATION_JSON_VALUE)
    JsonNode doThing(@RequestBody JsonNode thing);
}

3. 配置原理说明 #

Spring Cloud OpenFeign会为每个@FeignClient客户端创建独立的子ApplicationContext，每个子上下文仅会加载对应configuration指定的配置类中定义的Bean，天然实现不同客户端的配置隔离。只要专属配置类没有被主上下文扫描为全局Bean，两个客户端的Basic Auth拦截器就会独立加载、互不干扰。

排查提示：如果调整后仍返回4xx状态码，可添加配置feign.client.config.default.loggerLevel=full开启Feign全量请求日志，检查请求头中是否携带正确的Authorization: Basic xxx认证头，再核对用户名、密码是否与服务端要求一致。

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