【Spring Cloud】详解Feign经常使用配置

1 Feign经常使用配置

搭载着Spring Cloud的顺风车，Feign正以席卷之势成为使用Spring架构的大大小小互联网公司发起HTTP调用的首选框架。基于接口的声明式定义、客户端负载均衡、断路器和后备方法（fallback）是Feign相对上一代HTTP调用框架（好比Spring Template，Apache HttpClient）的四大优点。

相似于Retrofit和OkHttp的关系，Feign其实是对普通HTTP客户端的一层封装，其目的是下降集成成本、提高可靠性。Feign支持三种HTTP客户端，包括JDK自带的HttpURLConnection、Apache HttpClient和Square OkHttp，默认使用Apache HttpClient。

• HttpURLConnection：不支持线程池，通常不会选用。
• HttpClient：相比OkHttp，HttpClient并无明显的优点，多是由于使用更普遍，因此被Feign选为默认实现。从5.0版本开始才支持HTTP/2。
• OkHttp：开发Android应用的首选HTTP客户端，支持HTTP/2，经过设置feign.okhttp.enabled=true启用。

Feign提供了两大类配置属性来配置上述三种HTTP客户端，feign.client.*和feign.httpclient.*，前者支持按实例进行配置（注解-1），后者全局共享一套配置，包含线程池配置，但只影响HttpClient和OkHttp，不影响HttpURLConnection，具体关系见下表。

注解-1：所谓按实例进行配置，就是指每一个FeignClient实例均可以经过 feign.client.<feignClientName>.*来单独进行配置，注意首字母小写。而 feign.client.default.*表示默认配置。

HTTP客户端	链接超时时间	请求超时时间	线程存活时间	线程池最大链接数（全局）	线程池最大链接数（单个HOST）
HttpURLConnection	feign.client.[default|<feignClientName>].connect-timeout<br/>默认值：10秒	feign.client.[default|<feignClientName>].read-timeout<br/>默认值：60秒	N/A	N/A	N/A
HttpClient	feign.httpclient.connection-timeout<br/>默认值：2秒	默认值：-1（RequestConfig.Builder.socketTimeout）	feign.httpclient.time-to-live<br/>默认值：900秒	feign.httpclient.max-connections<br/>默认值：200	feign.httpclient.max-connections-per-route<br/>默认值：50
OkHttp	feign.httpclient.connection-timeout<br/>默认值：2秒	feign.client.[default|<feignClientName>].read-timeout<br/>默认值：10秒	feign.httpclient.time-to-live<br/>默认值：900秒	feign.httpclient.max-connections<br/>默认值：200	N/A

从上表能够看到，Feign提供了两个链接超时配置，HttpURLConnection使用feign.client.[default|<feignClientName>].connect-timeout，而HttpClient和OkHttp则使用feign.httpclient.connection-timeout，这一点要尤为注意。

2 启用Hystrix

经过设置feign.hystrix.enabled=true能够启用Feign的断路器支持（基于Hystrix）。跟Feign同样，Hystrix也支持按实例进行配置，详细配置属性参见官方文档。

因为Hystrix默认的请求超时时间为1秒，很容易触发超时异常，因此每每须要调大。调大超时时间有两种方式，

• 第一种方式，经过hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds设置默认超时时间，影响全部请求。
• 第二种方式，若是你不想改变全部请求的超时时间，那么能够经过hystrix.command.<HystrixCommandKey>.execution.isolation.thread.timeoutInMilliseconds单独设置某个Hystrix Command的超时时间。那么问题来了，Feign下面，这个Hystrix Command Key究竟是什么呢，是和Feign Client Name同样吗？答案是否认的。Feign下面，一个Hystrix Command对应的是Feign Client的一个方法，所以Hystrix Command Key的定义为<FeignClientName>#<methodName>(<arg1ClassName>,<arg2ClassName>...)，注意首字母大写，详见SetterFactory.Default#create()方法。

3 小结

不论是Spring仍是Spring Cloud，因为整个生态过于庞大，所以即使是官方文档，也只能勉强覆盖各个组件的大致框架，一旦深刻细节就只能靠开发者本身研读源码来寻找答案。就像Linus Torvalds说的，Talk is cheap. Show me the code.

4 参考

• Spring Cloud OpenFeign
• Spring cloud Feign 深度学习与应用
• Spring Cloud组件那么多超时设置，如何理解和运用？