Feign客户端自定义配置未生效问题排查

你遇到的核心问题是Feign客户端实例的双重创建逻辑冲突，加上Spring Cloud Sleuth的链路追踪增强介入，最终导致自定义OkHttpClient被覆盖：

1. 双重实例创建：你同时用了两种方式定义Feign客户端——既通过Feign.builder()手动注册MetaDataRestClient的Bean，又在接口上标注了@FeignClient注解。Spring Cloud Feign的自动配置会扫描@FeignClient注解生成代理Bean，而你手动注册的同名Bean会和自动生成的Bean产生冲突，触发两次初始化逻辑。
2. Sleuth的Feign增强：项目引入了Spring Cloud Sleuth后，它会自动对所有Feign客户端进行链路追踪增强，通过LazyClient包装原有的Feign Client实例。由于手动创建的Bean和@FeignClient生成的Bean冲突，Sleuth的增强逻辑会优先覆盖掉手动配置的OkHttpClient。

方案一：统一使用@FeignClient+配置类模式（推荐） #

移除手动创建Feign Client Bean的代码，完全依靠Spring Cloud Feign的自动配置机制，同时在配置类中定义所需的Feign组件：

1. 修改FeignConfiguration，仅配置Feign的基础组件，不手动创建MetaDataRestClient：

@RequiredArgsConstructor
@Configuration
public class FeignConfiguration{

    private final MyConfigurationProperties myConfigProperties;

    @Bean
    public okhttp3.OkHttpClient feignOkHttpClient() {
        return OkHttpUtil.createNewHttpClientBuilderWithProxy(
                myConfigProperties.getMetadata().getFeignClient().getConnectTimeout(),
                myConfigProperties.getMetadata().getFeignClient().getReadTimeout()
        ).build();
    }

    @Bean
    public Encoder feignEncoder() {
        return new JacksonEncoder(XML_MAPPER);
    }

    @Bean
    public Decoder feignDecoder() {
        return new JacksonDecoder(XML_MAPPER);
    }

    @Bean
    public Retryer feignRetryer() {
        return Retryer.NEVER_RETRY;
    }

    @Bean
    public Logger feignLogger() {
        return new Slf4jLogger(MetaDataRestClient.class);
    }

    @Bean
    public Logger.Level feignLogLevel() {
        return Logger.Level.FULL;
    }
}

2. 修改MetaDataRestClient的@FeignClient注解，用配置属性替换硬编码的url：

@FeignClient(name = "metaDataRestClient", url = "${my.config.metadata.endpoint}", configuration = FeignConfiguration.class)
public interface MetaDataRestClient {

    @Headers("Content-Type: text/xml")
    @GetMapping("/metadata")
    EntityDescriptor getMetadaData();
}

3. 删除配置类中手动创建MetaDataRestClient Bean的代码，让Spring Cloud Feign自动生成代理实例，此时Sleuth会正确增强该实例，同时保留你自定义的OkHttpClient配置。

方案二：禁用Sleuth对指定Feign Client的增强（仅当必须手动创建Bean时使用） #

如果坚持手动创建Feign Client Bean，需要让Sleuth跳过对该实例的包装：

1. 在application.yaml中添加配置，排除指定的Feign Client：

spring:
  sleuth:
    feign:
      clients:
        exclude: metaDataRestClient

2. 或者在手动创建的MetaDataRestClient Bean上添加Sleuth的@SkipSpan注解，标记为不进行链路追踪增强：

@Bean
@SkipSpan
public MetaDataRestClient metaDataRestClient(@Qualifier("metaDataHttpClient") okhttp3.OkHttpClient metaDataHttpClient) {
    // 原有的Feign.builder逻辑保持不变
}

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