name：指定FeignClient的名稱，如果項目使用了Ribbon，name屬性會作為微服務的名稱，用于服務發(fā)現(xiàn)
url: url一般用于調試，可以手動指定@FeignClient調用的地址
decode404:當發(fā)生http 404錯誤時，如果該字段位true，會調用decoder進行解碼，否則拋出FeignException
configuration: Feign配置類，可以自定義Feign的Encoder、Decoder、LogLevel、Contract
fallback: 定義容錯的處理類，當調用遠程接口失敗或超時時，會調用對應接口的容錯邏輯，fallback指定的類必須實現(xiàn)@FeignClient標記的接口
fallbackFactory: 工廠類，用于生成fallback類示例，通過這個屬性我們可以實現(xiàn)每個接口通用的容錯邏輯，減少重復的代碼
path: 定義當前FeignClient的統(tǒng)一前綴

日志級別配置

默認Feign是不打印任何日志的，下面我們來開啟Feign的日志，F(xiàn)eign有四種日志級別：

NONE【性能最佳，適用于生產(chǎn)】：不記錄任何日志（默認值）。
BASIC【適用于生產(chǎn)環(huán)境追蹤問題】：僅記錄請求方法、URL、響應狀態(tài)代碼以及執(zhí)行時間。
HEADERS：記錄BASIC級別的基礎上，記錄請求和響應的header。
FULL【比較適用于開發(fā)及測試環(huán)境定位問題】：記錄請求和響應的header、body和元數(shù)據(jù)。

在application.yml 中添加以下內(nèi)容，將該Feign接口的日志級別設置為DEBUG：

# 定義feign客戶端所在的路徑，需要設置日志級別為debug
logging.level: com.example.customer.service.CustomerService: debug
# user為服務名，單個配置客戶端日志級別設置，如果需要全局配置，把user更換為default
feign.client.config.user.loggerLevel: FULL

調用日志信息截圖

2020-06-07 14:06:27.671 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] ---> GET http://user/user HTTP/1.1
2020-06-07 14:06:27.671 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] ---> END HTTP (0-byte body)
2020-06-07 14:06:27.678 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] <--- HTTP/1.1 200 (7ms)
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] connection: keep-alive
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] content-type: application/json
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] date: Sun, 07 Jun 2020 06:06:27 GMT
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] keep-alive: timeout=60
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] transfer-encoding: chunked
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser]
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] {"id":1,"name":"test","phone":"119"}
2020-06-07 14:06:27.679 DEBUG 24961 --- [nio-8081-exec-3] c.e.customer.service.CustomerService : [CustomerService#getUser] <--- END HTTP (36-byte body)

服務超時、重試、降級和熔斷

·超時 Feign接口調用分兩層，Ribbon（負載均衡）和Hystrix（熔斷器）的調用，因此Feign的超時時間就是ribbon的超時時間和Hystrix的超時時間的結合

·重試 使用Ribbon

設置Ribbon重試次數(shù)

ribbon:
  #連接超時時間
  ConnectTimeout: 1000
  #讀超時時間
  ReadTimeout: 1000
  ##同一臺實例最大重試次數(shù),不包括首次調用
  MaxAutoRetries: 0
  #重試負載均衡其他的實例最大重試次數(shù),不包括首次調用
  MaxAutoRetriesNextServer: 1
  #是否所有操作都重試,設置false時，只會對get請求進行重試；如果設置為true，便會對所有的請求進行重試，如果是put或post等寫操作，如果服務器接口沒做冪等性,慎用；
  OkToRetryOnAllOperations: false

負載均衡配置

#服務名
user:
  ribbon:
    #選擇隨機算法
    NFLoadBalancerRuleClassName: com.netflix.loadbalancer.RandomRule

Ribbon Eager加載

默認情況下Ribbon是懶加載的——首次請求Ribbon相關類才會初始化，這會導致首次請求過慢的問題，你可以配置饑餓加載，讓Ribbon在應用啟動時就初始化。

ribbon:
  eager-load:
    enabled: true
    # 多個用,分隔
    clients: user

降級和熔斷使用hystrix

如果重試期間，調用時間超過了 Hystrix熔斷的超時時間，便會立即熔斷，進行FallBack

# 開啟hystrix
feign.hystrix.enabled: true 
# hystrix的超時時間 時間設置需要根據(jù)實際業(yè)務場景計算得出
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 10000

Fallback配置

@FeignClient(name = "user", fallback = CustomerFeignClientFallback.class)
public interface CustomerService {
 
  /**
   * 獲取用戶信息
   *
   * @return 用戶信息
   */
  @GetMapping("/user")
  UserDTO getUser ();
 
  @Component
  public class CustomerFeignClientFallback implements CustomerService {
 
    @Override
    public UserDTO getUser () {
     //todo 回退邏輯
      return new UserDTO().setName("服務降級");
    }
  }
}

@FeignClient(name = "user", fallbackFactory = CustomerFeignClientFallbackFactory.class)
public interface CustomerService {
 
  /**
   * 獲取用戶信息
   *
   * @return 用戶信息
   */
  @GetMapping("/user")
  UserDTO getUser ();
 
  @Component
  @Slf4j
  public class CustomerFeignClientFallbackFactory implements FallbackFactory<CustomerService> {
 
    @Override
    public CustomerService getUser () {
       //todo 回退邏輯
      return new UserDTO().setName("服務降級");
    }
  }
}

配置

logging:
  level:
    com.example.customer.service.CustomerService: debug
#全局配置，單個服務配置把default替換為需要設置的服務名
feign:
  client.config.default.loggerLevel: FULL
  okhttp.enabled: true
  #熔斷與回退
  hystrix.enabled: true
#重試機制
ribbon:
  #連接超時時間
  ConnectTimeout: 2000
  #讀超時時間
  ReadTimeout: 2000
  ##同一臺實例最大重試次數(shù),不包括首次調用
  MaxAutoRetries: 0
  #重試負載均衡其他的實例最大重試次數(shù),不包括首次調用
  MaxAutoRetriesNextServer: 1
  #是否所有操作都重試
  OkToRetryOnAllOperations: false
# Hystrix的超時時間
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 10000

有關Feign超時時間易混淆概念

Feign超時時間

feign.client.config.default.connectTimeout=10000 //Feign的連接建立超時時間，默認為10秒
feign.client.config.default.readTimeout=60000 //Feign的請求處理超時時間，默認為60

Ribbon 超時時間

ribbon.ReadTimeout=1000 //處理請求的超時時間，默認為1秒
ribbon.ConnectTimeout=1000 //連接建立的超時時長，默認1秒

Hystrix 超時時間

hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds=3000 #熔斷器的超時時長默認1秒

以上各種超時配置，如果都存在，則時間小的配置生效

小提示

Feign的底層是調用ribbon來實現(xiàn)負載均衡的，為了不和ribbon的重試機制沖突不需要配置feign超時時間和重試功能，只需配置ribbon和hystrix超時時間即可。
Ribbon超時時間必須小于hysrix超時設置，這樣才能觸發(fā)ribbon重試，ribbon重試分為兩種情況，同一實例重試和負載均衡的不同實例重試，默認為1次和0次
Feign的默認配置，是不啟用hystrix，需要開啟feign.hystrix.enabled=true，這樣hystrix的相關配置才可以在Feign中生效。
Hystrix的超時時間=Ribbon的重試次數(shù)(包含首次) * (ribbon.ReadTimeout + ribbon.ConnectTimeout)
在Ribbon超時但Hystrix沒有超時的情況下，Ribbon便會采取重試機制；而重試期間如果時間超過了Hystrix的超時配置則會立即被熔斷（fallback）
關系圖