OpenFeign的9个坑，每个都能让你的系统奔溃

发布时间：2025-11-05 02:40:13 来源：创站工坊 作者：系统运维

本文转载自微信公众号「程序员jinjunzhu」，的都作者jinjunzhu。个坑转载本文请联系程序员jinjunzhu公众号。系统

OpenFeign是奔溃SpringCloud中的重要组件，它是的都一种声明式的HTTP客户端。使用OpenFeign调用远程服务就像调用本地方法一样，个坑但是系统如果使用不当，很容易踩到坑。奔溃

坑一:用对Http Client

1.1 feign中http client

如果不做特殊配置，的都OpenFeign默认使用jdk自带的个坑HttpURLConnection，我们知道HttpURLConnection没有连接池、系统性能和效率比较低，奔溃如果采用默认，的都很可能会遇到性能问题导致系统故障。个坑

可以采用Apache HttpClient，系统properties文件中增加下面配置：

pom文件中增加依赖：

也可以采用OkHttpClient，properties文件中增加下面配置：

pom文件中增加依赖：

1.2 ribbon中的Http Client

通过OpenFeign作为注册中心的客户端时，默认使用Ribbon做负载均衡，Ribbon默认也是用jdk自带的HttpURLConnection，需要给Ribbon也设置一个Http client，WordPress模板比如使用okhttp，在properties文件中增加下面配置：

坑二：全局超时时间

OpenFeign可以设置超时时间，简单粗暴，设置一个全局的超时时间，如下：

如果不配置超时时间，默认是连接超时10s，读超时60s，在源码feign.Request的内部类Options中定义。

这个接口设置了最大的readTimeout是60s，这个时间必须大于调用的所有外部接口的readTimeout，否则处理时间大于readTimeout的接口就会调用失败。

如下图，在一个系统中使用OpenFeign调用外部三个服务，每个服务提供两个接口，其中serviceC的一个接口需要60才能返回，那上面的readTimeout必须设置成60s。

但是如果serviceA出故障了，表现是接口1超过60s才能返回，这样OpenFeign只能等到读超时，如果调用这个接口的并发量很高，源码库会大量占用连接资源直到资源耗尽系统奔溃。要防止这样的故障发生，就必须保证接口1能fail-fast。最好的做法就是给serviceC单独设置超时时间。

坑三：单服务设置超时时间

从上一节的讲解我们看到，需要对serviceC单独设置一个超时时间，代码如下：

这个时间会覆盖第一节中默认的超时时间。但是问题又来了，serviceC中又掉了serviceD，因为serviceD的故障导致接口6发生了读超时的情况，为了不让系统奔溃，不得不对serviceC的接口5单独设置超时时间。如下图：

坑四：熔断超时时间

怎样给单个接口设置超时时间，查看网上资料，必须开启熔断，配置如下：

开启熔断后，就可以给单个接口配置超时了。如果调用serviceC的接口5的声明如下：

根据上面interface5接口的声明，在properties文件中增加如下配置：

网上资料说的并不准确，这个超时时间并没有起作用。IT技术网为什么不生效呢?

4.1 使用feign超时

最终使用的超时时间来自于Options类。如果我们配置了feign的超时时间，会选择使用feign超时时间，下面代码在FeignClientFactoryBean类的configureUsingProperties方法：

4.2 使用ribbon超时

如果没有配置feign，但是配置了ribbon的超时时间，会使用ribbon的超时时间。我们看下这段源代码，FeignLoadBalancer里面的execute方法，

4.3 使用自定义Options

对于单个接口怎么配置超时时间，我这里给出一个方案，如果你有其他方案，欢迎探讨。我的方案是使用RestTemplate来调这个接口，单独配置超时时间，配置代码如下，这里使用OkHttpClient：

为了使用ribbon负载均衡，上面加了@LoadBalanced

如果使用RestTemplate，就会使用OkHttp3ClientHttpRequestFactory中配置的时间。

坑五：ribbon超时时间

作为负载均衡，ribbon超时时间也是可以配置的，可以在properties增加下面配置：

有文章讲ribbon配置的超时时间必须要满足接口响应时间，其实不然，配置feign的超时时间就足够了，因为它可以覆盖掉ribbon的超时时间。

坑六：重试默认不开启

OpenFeign默认是不支持重试的，可以在源代码FeignClientsConfiguration中feignRetryer中看出。

要开启重试，我们可以自定义Retryer，比如下面这行代码：

表示每间隔100ms，最大间隔1000ms重试一次，最大重试次数是1，因为第三个参数包含了第一次请求。

坑七：Ribbon重试

7.1 拉取服务列表

Ribbon默认从服务端拉取列表的时间间隔是30s，这个对优雅发布很不友好，一般我们会把这个时间改短，如下改成3s：

7.2 重试

Ribbon重试有不少需要注意的地方，这里分享4个。

1.同一实例最大重试次数，不包括首次调用，配置如下：

这个次数不包括首次调用，配置了1，重试策略会先尝试在失败的实例上重试一次，如果失败，请求下一个实例。

2.同一个服务其他实例的最大重试次数，这里不包括第一次调用的实例。默认值为1：

3.是否对所有操作都重试，如果改为true，则对所有操作请求都进行重试,包括post，建议采用默认配置false。

4.对指定的http状态码进行重试

坑八：hystrix超时

如下图：

hystrix默认不开启，但是如果开启了hystrix，因为hystrix是在Ribbon外面，所以超时时间需要符合下面规则：hystrix超时 >= (MaxAutoRetries + 1) * (ribbon ConnectTimeout + ribbon ReadTimeout)

如果Ribbon不重试，MaxAutoRetries=0

根据上面公式，假如我们配置熔断超时时间如下：

这个配置是不会重试一次的。serviceA调用serviceB时，hystrix会等待Ribbon返回的结果，如果Ribbon配置了重试，hystrix会一直等待直到超时。上面的配置，因为第一次请求已经耗去了8s，剩下时间7s不够请求一次了，所以是不会进行重试的。

坑九：使用OpenFeign做http客户端

即使不用注册中心，使用OpenFeign做普通http客户端也是很方便的，但是有三点需要注意：

相关文章