Spring Cloud中关于Feign的常见问题总结

爱被打了一巴掌 2024-02-19 13:05 65阅读 0赞

这篇文章主要给大家介绍了Spring Cloud中关于Feign的常见问题，文中通过示例代码介绍的很详细，需要的朋友可以参考借鉴，下面来一起看看吧。

**一、FeignClient接口，不能使用@GettingMapping 之类的组合注解**

**代码示例：**

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> <p>2</p> <p>3</p> <p>4</p> <p>5</p> <p>6</p> </td> 
   <td> <p><code>@FeignClient</code><code>(</code><code>"microservice-provider-user"</code><code>)</code></p> <p><code>public</code> <code>interface</code> <code>UserFeignClient { </code></p> <p><code>&nbsp;</code><code>@RequestMapping</code><code>(value = </code><code>"/simple/{id}"</code><code>, method = RequestMethod.GET)</code></p> <p><code>&nbsp;</code><code>public</code> <code>User findById(</code><code>@PathVariable</code><code>(</code><code>"id"</code><code>) Long id);</code></p> <p><code>&nbsp;</code><code>...</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

这边的`@RequestMapping(value = "/simple/{id}", method = RequestMethod.GET)`不能写成`@GetMapping("/simple/{id}")`。

二、FeignClient接口中，如果使用到@PathVariable ，必须指定其value

**代码示例：**

这边的`@PathVariable("id")`中的”id”，不能省略，必须指定。

**三、FeignClient多参数的构造**

如果想要请求microservice-provider-user 服务，并且参数有多个例如：http://microservice-provider-user/query-by?id=1&username=张三 要怎么办呢？

**直接使用复杂对象：**

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> <p>2</p> <p>3</p> <p>4</p> <p>5</p> <p>6</p> </td> 
   <td> <p><code>@FeignClient</code><code>(</code><code>"microservice-provider-user"</code><code>)</code></p> <p><code>public</code> <code>interface</code> <code>UserFeignClient { </code></p> <p><code>&nbsp;</code><code>@RequestMapping</code><code>(value = </code><code>"/query-by"</code><code>, method = RequestMethod.GET)</code></p> <p><code>&nbsp;</code><code>public</code> <code>User queryBy(User user);</code></p> <p><code>&nbsp;</code><code>...</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

该请求不会成功，只要参数是复杂对象，即使指定了是GET方法，feign依然会以POST方法进行发送请求。

**正确的写法：**

写法1：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> <p>2</p> <p>3</p> <p>4</p> <p>5</p> </td> 
   <td> <p><code>@FeignClient</code><code>(</code><code>"microservice-provider-user"</code><code>)</code></p> <p><code>public</code> <code>interface</code> <code>UserFeignClient { </code></p> <p><code>&nbsp;</code><code>@RequestMapping</code><code>(value = </code><code>"/query-by"</code><code>, method = RequestMethod.GET)</code></p> <p><code>&nbsp;</code><code>public</code> <code>User queryBy(</code><code>@RequestParam</code><code>(</code><code>"id"</code><code>)Long id, </code><code>@RequestParam</code><code>(</code><code>"username"</code><code>)String username);</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

写法2：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> <p>2</p> <p>3</p> <p>4</p> <p>5</p> </td> 
   <td> <p><code>@FeignClient</code><code>(name = </code><code>"microservice-provider-user"</code><code>)</code></p> <p><code>public</code> <code>interface</code> <code>UserFeignClient { </code></p> <p><code>&nbsp;</code><code>@RequestMapping</code><code>(value = </code><code>"/query-by"</code><code>, method = RequestMethod.GET)</code></p> <p><code>&nbsp;</code><code>public</code> <code>List&lt;User&gt; queryBy(</code><code>@RequestParam</code> <code>Map&lt;String, Object&gt; param);</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

**四、Feign如果想要使用Hystrix Stream，需要做一些额外操作**

我们知道Feign本身就是支持Hystrix的，可以直接使用`@FeignClient(value = "microservice-provider-user", fallback = XXX.class)` 来指定fallback的类，这个fallback类集成@FeignClient所标注的接口即可。

但是假设我们需要使用Hystrix Stream进行监控，默认情况下，访问http://IP:PORT/hystrix.stream 是个404。如何为Feign增加Hystrix Stream支持呢？

**需要以下两步：**

第一步：添加依赖，示例：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> <p>2</p> <p>3</p> <p>4</p> <p>5</p> </td> 
   <td> <p><code>&lt;!-- 整合hystrix，其实feign中自带了hystrix，引入该依赖主要是为了使用其中的hystrix-metrics-event-stream，用于dashboard --&gt;</code></p> <p><code>&lt;dependency&gt;</code></p> <p><code>&nbsp;</code><code>&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;</code></p> <p><code>&nbsp;</code><code>&lt;artifactId&gt;spring-cloud-starter-hystrix&lt;/artifactId&gt;</code></p> <p><code>&lt;/dependency&gt;</code></p> </td> 
  </tr> 
 </tbody> 
</table>

第二步：在启动类上添加@EnableCircuitBreaker 注解，示例：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> <p>2</p> <p>3</p> <p>4</p> <p>5</p> <p>6</p> <p>7</p> <p>8</p> <p>9</p> </td> 
   <td> <p><code>@SpringBootApplication</code></p> <p><code>@EnableFeignClients</code></p> <p><code>@EnableDiscoveryClient</code></p> <p><code>@EnableCircuitBreaker</code></p> <p><code>public</code> <code>class</code> <code>MovieFeignHystrixApplication { </code></p> <p><code>&nbsp;</code><code>public</code> <code>static</code> <code>void</code> <code>main(String[] args) { </code></p> <p><code>&nbsp;</code><code>SpringApplication.run(MovieFeignHystrixApplication.</code><code>class</code><code>, args);</code></p> <p><code>&nbsp;</code><code>}</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

这样修改以后，访问任意的API后，再访问http://IP:PORT/hystrix.stream，就会展示出一大堆的API监控数据了。

**五、如果需要自定义单个Feign配置，Feign的@Configuration 注解的类不能与@ComponentScan 的包重叠**

如果包重叠，将会导致所有的Feign Client都会使用该配置。

**六、首次请求失败**

详见：[解决Spring Cloud中Feign/Ribbon第一次请求失败的方法][Spring Cloud_Feign_Ribbon]

在Spring Cloud中，Feign和Ribbon在整合了Hystrix后，可能会出现首次调用失败的问题，要如何解决该问题呢？
    
    造成该问题的原因
    
    Hystrix默认的超时时间是1秒，如果超过这个时间尚未响应，将会进入fallback代码。而首次请求往往会比较慢（因为Spring的懒加载机制，要实例化一些类），这个响应时间可能就大于1秒了。知道原因后，我们来总结一下解决放你。
    
    解决方案有三种，以feign为例。
    
    方法一
    hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 5000
    该配置是让Hystrix的超时时间改为5秒
    
    方法二
    hystrix.command.default.execution.timeout.enabled: false
    该配置，用于禁用Hystrix的超时时间
    
    方法三
    
    feign.hystrix.enabled: false
    该配置，用于索性禁用feign的hystrix。该做法除非一些特殊场景，不推荐使用。
    
    总结
    
    以上就是关于Spring Cloud中解决Feign/Ribbon第一次请求失败的全部内容，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。

**七、@FeignClient 的属性注意点**

(1) serviceId属性已经失效，尽量使用name属性。例如：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> </td> 
   <td> <p><code>@FeignClient</code><code>(serviceId = </code><code>"microservice-provider-user"</code><code>)</code></p> </td> 
  </tr> 
 </tbody> 
</table>

这么写是不推荐的，应写为：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> </td> 
   <td> <p><code>@FeignClient</code><code>(name = </code><code>"microservice-provider-user"</code><code>)</code></p> </td> 
  </tr> 
 </tbody> 
</table>

(2) 在使用url属性时，在老版本的Spring Cloud中，不需要提供name属性，但是在新版本（例如Brixton、Camden）@FeignClient必须提供name属性，并且name、url属性支持占位符。例如：

<table> 
 <tbody> 
  <tr> 
   <td> <p>1</p> </td> 
   <td> <p><code>@FeignClient</code><code>(name = </code><code>"${feign.name}"</code><code>, url = </code><code>"${feign.url}"</code><code>)</code></p> </td> 
  </tr> 
 </tbody> 
</table>

**总结**

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。

[Spring Cloud_Feign_Ribbon]: https://www.jb51.net/article/106944.htm