spring cloud zuul实践

一、 描述

Spring Cloud Zuul是基于Netflix开源的Zuul项目构建而成，它作为微服务架构中的网关服务，主要用于实现动态路由、负载均衡和请求过滤等功能。

1. 动态路由：Zuul根据预设的路由规则将进来的请求路由到相应的服务实例上。路由规则可以通过配置文件或代码进行定义，接收到请求后，Zuul会解析请求的URL，并根据配置的路由规则找到对应的服务地址，将请求转发到目标服务。

2. 负载均衡：Zuul内置了Ribbon负载均衡器，可以对请求进行负载均衡。当一个服务有多个实例时，Zuul可以使用负载均衡算法将请求均匀地分发到不同的实例上，以提高系统的性能和可扩展性。

3. 请求过滤：Zuul支持自定义过滤器，在请求被路由之前或之后对请求进行处理。过滤器可以用于在路由前进行身份验证、请求统计、参数校验等操作，也可以在路由后处理响应结果，比如修改返回数据、添加自定义的响应头等。开发者可以根据需求创建不同类型的过滤器，并定义过滤器的执行顺序。

4. 整合服务注册中心：Zuul可以与服务注册中心（如Zookeeper、Eureka）进行整合，实现动态路由和负载均衡。通过与服务注册中心交互，Zuul能够动态地获取服务实例的信息，并根据需要进行路由和负载均衡。

5. 高可用和容错：Zuul支持配置多个实例运行在不同的机器上，以实现高可用性。当一个Zuul实例发生故障时，其他实例可以接管请求处理，确保系统的稳定性和容错性。

Spring Cloud Zuul通过动态路由、负载均衡和请求过滤等机制，提供了一个强大且灵活的网关服务。它能够统一管理微服务的入口，实现请求的转发和过滤，简化了微服务架构中的通信和调用方式，提高了系统的可伸缩性和可维护性。

      下面是使用Spring Cloud Zuul的一般实践步骤

二、添加依赖

引入zuul的依赖spring-cloud-starter-netflix-zuul

    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
    </dependency>

三、创建启动类：

      创建一个启动类，并使用@EnableZuulProxy注解开启Zuul代理功能。

@SpringBootApplication
@EnableZuulProxy
public class GatewayApplication {

  public static void main(String[] args) {
    SpringApplication.run(GatewayApplication.class, args);
  }

}

四、 配置

在配置文件（如application.yml）中定义Zuul的路由规则。可以使用Zuul的zuul.routes前缀来配置不同的路由规则。

server:
  port: 9000
management:
  endpoints:
    web:
      exposure:
        include: '*'
  server:
    port: 12345
zuul:
  routes:
    configserver:
      path: /myConfig/**
      serviceId: config
    user:
      path: /myUser/**
      serviceId: provider
  ignored-patterns: #忽略指定的路由
    - /config/**
    - /gateway/**
  sensitive-headers:
#  ignore-local-service: true # 忽略原来自身的路由。比如，true: 原来的config/xxx/xxx不可再访问

上述配置将/myConfig/**的请求转发到config服务，将/myUser/**的请求转发到provider服务。

还可以将网关注册到注册中心实现高可用。创建bootstrap.yml文件

spring:
  application:
    name: gateway
  cloud:
    zookeeper:
      discovery:
        register: true
        enabled: true
      connect-string: 192.168.3.100:2181
    config:
      discovery:
        service-id: config
        enabled: true

五、配置过滤器

 通过zuul添加过滤器，对请求进行拦截或校验等等

package com.mike.study.gateway.fiter;

import com.netflix.zuul.ZuulFilter;
import com.netflix.zuul.context.RequestContext;
import com.netflix.zuul.exception.ZuulException;
import org.apache.commons.lang.StringUtils;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;

import javax.servlet.http.HttpServletRequest;

import static org.springframework.cloud.netflix.zuul.filters.support.FilterConstants.PRE_DECORATION_FILTER_ORDER;
import static org.springframework.cloud.netflix.zuul.filters.support.FilterConstants.PRE_TYPE;

/**
 * @Classname ParameterFilter
 * @Created by Michael
 * @Date 2023/7/12
 * @Description 自定义过滤器
 */
@Component
public class ParameterFilter extends ZuulFilter {
  /**
   * 前置过滤
   * @return
   */
  @Override
  public String filterType() {
    return PRE_TYPE;
  }

  /**
   * 数值越小，优先级越高
   * @return
   */
  @Override
  public int filterOrder() {
    return PRE_DECORATION_FILTER_ORDER - 1;
  }

  @Override
  public boolean shouldFilter() {
    return true;
  }

  @Override
  public Object run() throws ZuulException {

    // 获取请求对象
    RequestContext context = RequestContext.getCurrentContext();
    HttpServletRequest request = context.getRequest();
    // 获取地址栏传入的参数
    String token = request.getParameter("token");
    System.out.println("token ===>"+token);
    //模拟校验token，没有token则终止转发
    if (StringUtils.isEmpty(token)) {
      context.setSendZuulResponse(false);
      context.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
    }
    return null;
  }
}

以上代码时在转发请求服务前，对参数进行校验，如果没有token参数，则停止转发，并且返回401错误

六、测试

测试网关转发主要需要请求发起方，网关和请求处理方。这里在原来demo的基础上，增加网关，所以看到有配置中心，以往的文章有项目的搭建介绍。如果不想那么复杂，可以去掉配置中心，将配置放置各个module即可，项目组如下

 

准备请求发起方，即consumer，controller通过feign框架请求网关，网关转发请求provider。consumer的controller如下

import com.mike.study.orderconsumer.client.UserClient;
import com.mike.study.orderconsumer.vo.UserVo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

/**
 * @Classname UserRuttingController
 * @Created by Michael
 * @Date 2023/7/9
 * @Description feign框架调用provider api
 */
@RestController
public class UserRuttingController {
  @Resource
  private UserClient userClient;

  @GetMapping("warp/user/2.1/{id}")
  public UserVo getUser(@PathVariable("id") Integer userId, @RequestParam("token") String token) {
    System.out.println("使用feign框架调用provide的api");
    return userClient.getUser(userId, token);
  }
}

Feign接口

import com.mike.study.orderconsumer.vo.UserVo;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * @Classname UserFeigClient
 * @Created by Michael
 * @Date 2023/7/9
 * @Description feign client
 */

@FeignClient("gateway")
public interface UserClient {

  @GetMapping("myUser/user/{id}")
  public UserVo getUser(@PathVariable("id") Integer userId,@RequestParam("token") String token);
}

以上Feign接口配合注册中心zookeeper使用,访问的网关地址，而不是直接请求服务提供者的api。

provider module简单提供一个api查询用户信息。

六、测试结果

positive case：token参数有值

 negative case：token参数i为空

 

总结，就是consumer不再直接请求provider server，而是通过zuul作为中转站，这样做的好处很多，比如，对consumer的请求进行拦截过滤，验证，降流等等。