微服务实战|微服务网关Zuul入门与实战

关注

原创最新推荐文章于 2026-07-18 13:14:08 发布 1.2k 阅读 AI 写同款· GEO 优化 ›

Zuul的api-gateway转发多个服务，静态资源访问用Zuul作为api网关，转发到多个微服务，访问这些微服务中的静态资源通过在zuul中为要访问的微服务的路径取别名 zuul转发到其他服务，静态资源的访问路径发生改变由原来的本项目的 ip + 端口 + href路径变为： zuul的ip+zuul的端口+href路径 zuul路由设置 server: # 服务端口号 port: 8001 # 设置路由映射 # zuul会... 阅读详情

网关的作用

微服务架构中，服务实例的地址可能经常会发生变化，所以我们不能直接将服务的地址暴露出来。如果每一个微服务都直接暴露接口，会导致一系列的问题，比如调用过于复杂，涉及到账户、权限不能统一处理等。另外基于高内聚低耦合的设计准则来讲，我们也应该将内部系统和外部系统做切割。

因此，这时就需要有一个独立的组件来处理外部的请求，这个组件就是服务网关。服务网关就是为了简化前端的调用逻辑，通常情况下也会实现相关的认证逻辑，根据外部不同的请求响应不同的数据，从而简化内外部系统之间调用的复杂度。
在这里插入图片描述
服务网关负责服务请求路由、组合及协议转换。客户端的所有请求都首先经过服务网关，然后由它将请求路由到合适的微服务。服务网关经常会通过调用多个微服务并合并结果来处理一个请求，它可以在系统外部与内部响应之间友好的转换。

本文将先着重介绍Zuul组件。

Spring Cloud 网关组件Zuul介绍

Zuul 是 Netflix 公司开源的产品，被称为第一代网关，也是 Spring Cloud 前几个版本默认使用的一款提供动态路由微服务网关组件。Zuul 接收所有外来请求，并将请求转发到对应的后端服务。作为一个前置服务，Zuul 旨在实现动态路由，监控，弹性和安全性等功能。

Zuul 提供了不同类型的 filter 用于处理请求，这些 filter 可以让我们实现以下功能：

权限控制和安全性：可以识别认证需要的信息和拒绝不满足条件的请求。
监控：与边缘位置追踪有意义的数据和统计结果，从而带来精确的生产视图。
动态路由：根据需要动态地路由请求到后台的不同集群。
压力测试：逐渐增加指向集群的流量，以了解性能。
负载均衡：为每一种负载类型分配对应容量，并弃用超出限定值的请求
静态资源处理：直接在 zuul 处理静态资源的响应，从而避免其转发到内部集群。

Zuul网关实战

之前的介绍中，我们启动了注册中心registry，dms服务，和app服务，请求时，直接调用了app服务的接口，app服务又调用了dms服务：

在这里插入图片描述

加上网关服务之后，就会变成如下：
在这里插入图片描述

接下来，我们创建zuul服务：

1、创建服务

创建子模块zuul，pom.xml引入eureka-client 和zuul的依赖

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

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

        <!-- feign -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

        <!-- zuul路由 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
        </dependency>

2、创建配置文件

server:
  port: 8004
spring:
  application:
    name: zuul

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8001/eureka/
feign:
  hystrix:
    enabled: true
zuul:
  routes:
    app: #活动
      path: /app/** #配置请求URL的请求规则
      serviceId: app #指定Eureka注册中心中的服务id
    dms: #活动
      path: /dms/** #配置请求URL的请求规则
      serviceId: dms #指定Eureka注册中心中的服务id
logging:
  pattern:
    console: '%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%thread] %logger{15} - %msg%n'

3、创建Zuul过滤器

/**
 * @Author:公众号：程序员965
 * @create 2022-06-30
 **/
@Component
public class MyZuulFilter extends ZuulFilter {

//    pre ：可以在请求被路由之前调用
//    route ：在路由请求时候被调用
//    post ：在route和error过滤器之后被调用
//    error ：处理请求时发生错误时被调用
    @Override
    public String filterType() {
        return "pre";// 前置过滤器
    }

    //通过int值来定义过滤器的执行顺序,优先级为0，数字越大，优先级越低
    @Override
    public int filterOrder() {
        return 0;
    }

    //返回一个boolean类型来判断该过滤器是否要执行，所以通过此函数可实现过滤器的开关
    @Override
    public boolean shouldFilter() {
        return true;//此处为true，说明需要过滤
    }

    //过滤器的具体逻辑。
    @Override
    public Object run() throws ZuulException {
        // 获取上下文
        RequestContext currentContext = RequestContext.getCurrentContext();
        HttpServletRequest request = currentContext.getRequest();
        String accessToken = request.getParameter("accessToken");
        if (StringUtils.isEmpty(accessToken)) {
            //setSendZuulResponse(false)令zuul过滤该请求，不进行路由
            currentContext.setSendZuulResponse(false);
            //设置返回的错误码
            currentContext.setResponseStatusCode(401);
            currentContext.setResponseBody("AccessToken is null");
            return null;
        }
        System.out.println("获取到AccessToken为:"+accessToken);
        // 否则正常执行业务逻辑.....
        return null;
    }
}

4、编写启动类

注意增加@EnableZuulProxy注解

/**
 * @Author:公众号：程序员965
 * @create 2022-06-30
 **/
@EnableZuulProxy
@EnableEurekaClient
@SpringBootApplication
public class ZuulApplication {
    public static void main(String[] args) {
        SpringApplication.run(ZuulApplication.class, args);
    }
}