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

一、feignclient接口，不能使用@gettingmapping 之类的组合注解

代码示例：

@feignclient("microservice-provider-user")
public interface userfeignclient {
 @requestmapping(value = "/simple/{id}", method = requestmethod.get)
 public user findbyid(@pathvariable("id") long id);
 ...
}

这边的@requestmapping(value = "/simple/{id}", method = requestmethod.get) 不能写成@getmapping("/simple/{id}") 。

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

代码示例：

@feignclient("microservice-provider-user")
public interface userfeignclient {
 @requestmapping(value = "/simple/{id}", method = requestmethod.get)
 public user findbyid(@pathvariable("id") long id);
 ...
}

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

三、feignclient多参数的构造

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

直接使用复杂对象：

@feignclient("microservice-provider-user")
public interface userfeignclient {
 @requestmapping(value = "/query-by", method = requestmethod.get)
 public user queryby(user user);
 ...
}

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

正确的写法：

写法1：

@feignclient("microservice-provider-user")
public interface userfeignclient {
 @requestmapping(value = "/query-by", method = requestmethod.get)
 public user queryby(@requestparam("id")long id, @requestparam("username")string username);
}

写法2：

@feignclient(name = "microservice-provider-user")
public interface userfeignclient {
 @requestmapping(value = "/query-by", method = requestmethod.get)
 public list<user> queryby(@requestparam map<string, object> param);
}

四、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支持呢？

需要以下两步：

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

<!-- 整合hystrix，其实feign中自带了hystrix，引入该依赖主要是为了使用其中的hystrix-metrics-event-stream，用于dashboard -->
<dependency>
 <groupid>org.springframework.cloud</groupid>
 <artifactid>spring-cloud-starter-hystrix</artifactid>
</dependency>

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

@springbootapplication
@enablefeignclients
@enablediscoveryclient
@enablecircuitbreaker
public class moviefeignhystrixapplication {
 public static void main(string[] args) {
 springapplication.run(moviefeignhystrixapplication.class, args);
 }
}

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

五、如果需要自定义单个feign配置，feign的@configuration 注解的类不能与@componentscan 的包重叠

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

六、首次请求失败

详见：解决spring cloud中feign/ribbon第一次请求失败的方法

七、@feignclient 的属性注意点

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

@feignclient(serviceid = "microservice-provider-user")

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

@feignclient(name = "microservice-provider-user")

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

@feignclient(name = "${feign.name}", url = "${feign.url}")

总结

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