Spring Cloud 踩坑记录

18年年初开始接触Spring Cloud技术栈，在做项目过程中踩了很多坑，也收获很多知识，在此记录一下。

1、Feign

（1）使用Feign进行方法调用时，FeignClient中无法传递List类型的参数，需要改为数组类型。比如说批量删除接口，@PathVariable应该接受Long[] ids类型参数，而不是List<Long> ids参数。

（2）当被调用放抛出异常时，Feign都会把异常封装一层，调用层次越深，异常栈越深。所以一般需要手动编写一个ErrorDecoder，将异常信息拿出来，并且在Controller层抛出最深一层的e.getCause()。或者写一个统一的@ControllerAdvice类处理项目所有controller中抛出的异常。

（3）在FeignClient中，对于POST和PUT请求，应该在@RequestMapping中加上consumes=MediaType.APPLICATION_JSON_VALUE，否则会出现MIME Type相关错误，这是因为Feign收到的Mediatype中mediatype和charset是混在一起的，导致解析mediatype失败。

（4）FeignClient中，对于@PathVariable注解，必须指定其value属性，如下代码中的"id"不能省略。

@FeignClient("microservice-provider-user")
public interface UserFeignClient {
  @RequestMapping(value = "/simple/{id}", method = RequestMethod.GET)
  public User findById(@PathVariable("id") Long id);
  ...
}

2、Spring Data JPA

（2）使用JPA nativeQuery时，SQL语句不能以分号结尾，否则会报错：JPA-style positional param was not an integral ordinal

3、Hystrix

（1）在不涉及到RPC调用时最好设置隔离方式为信号量隔离

（2）要特别注意，对于restful抛出的4xx的错误，也许大部分是业务异常，并不是服务提供方的异常，因此在进行feign client调用的时候，需要进行errorDecoder去处理，适配为HystrixBadRequestException，好避开circuit breaker的统计，否则就容易误判，传几个错误的参数，立马就熔断整个服务了，后果不堪设想。也可以让自定义的业务异常继承HystrixBadRequestException，这样就不会走熔断了。

4、Zipkin

（1）使用Camden.SR4版本的微服务搭建Zipkin客户端报错：

找不到org.springframework.boot.context.embedded.FilterRegistrationBean，查看源码发现：在1.5.6版本中FilterRegistrationBean的包路径已经改为org.springframework.boot.web.servlet.org.springframework.boot.web.servlet.FilterRegistrationBean,所以引发错误。

解决办法：既然是引用了以前的包路径，说明是pom.xml文件的问题。检查发现spring-cloud-dependencies 的版本没有更新，改为Dalston.SR3即可解决问题。

（2）不要用spring boot 2.0搭zipkin server，该死的2.0把spring-boot包的结构变了导致ZipkinServerConfiguration里报错.UndertowEmbeddedServletContainerFactory

这个类在1.5是放在org/springframework/boot/context/embedded/undertow下的，

2.0挪到了org/springframework/boot/web/embedded/undertow