feignclient url_Feign常见问题总结

TIPS

本文基于Spring Clou Greenwich SR1，理论支持Spring Cloud Finchley及更高版本。

本文总结Feign常见问题及解决方案。

一、使用案例

二、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"，也就是value属性，必须指定，不能省略。

三、Java代码自定义Feign Client的注意点与坑

代码示例：

@FeignClient(name = "microservice-provider-user", configuration = UserFeignConfig.class)

public interface UserFeignClient {

@GetMapping("/users/{id}")

User findById(@PathVariable("id") Long id);

}

/**

* 该Feign Client的配置类，注意：

* 1. 该类可以独立出去；

* 2. 该类上也可添加@Configuration声明是一个配置类；

* 配置类上也可添加@Configuration注解，声明这是一个配置类；

* 但此时千万别将该放置在主应用程序上下文@ComponentScan所扫描的包中，

* 否则，该配置将会被所有Feign Client共享，无法实现细粒度配置！

* 个人建议：像我一样，不加@Configuration注解

*

* @author zhouli

*/

class UserFeignConfig {

@Bean

public Logger.Level logger() {

return Logger.Level.FULL;

}

}

配置类上也可添加@Configuraiton 注解，声明这是一个配置类；但此时千万别将该放置在主应用程序上下文@ComponentScan 所扫描的包中，否则，该配置将会被所有Feign Client共享(相当于变成了通用配置，其实本质还是Spring父子上下文扫描包重叠导致的问题)，无法实现细粒度配置！

个人建议：像我一样，不加@Configuration注解，省得进坑。

四、@FeignClient 注解属性

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

在早期的Spring Cloud版本中，无需提供name属性，从Brixton版开始，@FeignClient必须提供name属性，否则应用将无法正常启动！

另外，name、url等属性支持占位符。例如：

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

五、类级别的@RequestMapping会被Spring MVC加载

@RequestMapping("/users")

@FeignClient(name = "microservice-user")

public class TestFeignClient {

// ...

}

类上的@RequestMapping 注解也会被Spring MVC加载。该问题现已经被解决，早期的版本有两种解决方案：

方案1：不在类上加@RequestMapping 注解；

方案2：添加如下代码：

@Configuration

@ConditionalOnClass({ Feign.class })

public class FeignMappingDefaultConfiguration {

@Bean

public WebMvcRegistrations feignWebRegistrations() {

return new WebMvcRegistrationsAdapter() {

@Override

public RequestMappingHandlerMapping getRequestMappingHandlerMapping() {

return new FeignFilterRequestMappingHandlerMapping();

}

};

}

private static class FeignFilterRequestMappingHandlerMapping extends RequestMappingHandlerMapping {

@Override

protected boolean isHandler(Class> beanType) {

return super.isHandler(beanType) && !beanType.isInterface();

}

}

}

六、首次请求失败

七、如需产生Hystrix Stream监控信息，需要做一些额外操作

Feign本身已经整合了Hystrix，可直接使用@FeignClient(value = "microservice-provider-user", fallback = XXX.class) 来指定fallback类，fallback类继承@FeignClient所标注的接口即可。

但是假设如需使用Hystrix Stream进行监控，默认情况下，访问http://IP:PORT/actuator/hystrix.stream 是会返回404，这是因为Feign虽然整合了Hystrix，但并没有整合Hystrix的监控。如何添加监控支持呢？需要以下几步：

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

org.springframework.cloud

spring-cloud-starter-hystrix

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

@SpringBootApplication

@EnableFeignClients

@EnableDiscoveryClient

@EnableCircuitBreaker

public class MovieFeignHystrixApplication {

public static void main(String[] args) {

SpringApplication.run(MovieFeignHystrixApplication.class, args);

}

}

第三步：在application.yml中添加如下内容，暴露hystrix.stream端点：

management:

endpoints:

web:

exposure:

include: 'hystrix.stream'

这样，访问任意Feign Client接口的API后，再访问http://IP:PORT/actuator/hystrix.stream ，就会展示一大堆Hystrix监控数据了。

本文首发