Gateway：Spring Cloud API组件（非常详细）

2年前 (2024-04-26)

在微服务架构中，一个系统往往由多个微服务组成，而这些服务可能部署在不同机房、不同地区、不同域名下。这种情况下，客户端（例如浏览器、手机、软件工具等）想要直接请求这些服务，就需要知道它们具体的地址信息，例如 IP 地址、端口号等。

这种客户端直接请求服务的方式存在以下问题：

当服务数量众多时，客户端需要维护大量的服务地址，这对于客户端来说，是非常繁琐复杂的。

在某些场景下可能会存在跨域请求的问题。

身份认证的难度大，每个微服务需要独立认证。

我们可以通过 API 来解决这些问题，下面就让我们来看看什么是 API 。

API

API 是一个搭建在客户端和微服务之间的服务，我们可以在 API 中处理一些非业务功能的逻辑，例如权限验证、监控、缓存、请求路由等。

API 就像整个微服务系统的门面一样，是系统对外的入口。有了它，客户端会先将请求发送到 API ，然后由 API 根据请求的标识信息将请求转发到微服务实例。

图1：两种服务访问方式对比

对于服务数量众多、复杂度较高、规模比较大的系统来说，使用 API 具有以下好处：

客户端通过 API 与微服务交互时，客户端只需要知道 API 地址即可，而不需要维护大量的服务地址，简化了客户端的开发。

客户端直接与 API 通信，能够减少客户端与各个服务的交互次数。

客户端与后端的服务耦度降低。

节省流量，提高性能，用户体验。

API 还提供了安全、流控、过滤、缓存、计费以及监控等 API 管理功能。

常见的 API 实现方案主要有以下 5 种：

Spring Cloud Gateway

Spring Cloud Netflix Zuul

Kong

Nginx+Lua

Traefik

本节，我们就对 Spring Cloud Gateway 进行详细介绍。

Spring Cloud Gateway

Spring Cloud Gateway 是 Spring Cloud 团队基于 Spring 5.0、Spring Boot 2.0 和 Project Reactor 等技术开发的高性能 API 组件。

Spring Cloud Gateway 旨在提供一种简单而有效的途径来发送 API，并为它们提供横切关注点，例如：安全性，监控/指标和弹性。

Spring Cloud Gateway 是基于 WebFlux 框架实现的，而 WebFlux 框架底层则使用了高性能的 Reactor 模式通信框架 Netty。

Spring Cloud Gateway 核心概念

Spring Cloud GateWay 最主要的功能就是路由转发，而在定义转发规则时主要涉及了以下三个核心概念，如下表。

核心概念	描述
Route（路由）	最基本的模块。它由一个 ID、一个目标 URI、一组断言（Predicate）和一组过滤器（Filter）组成。
Predicate（断言）	路由转发的判断条件，我们可以通过 Predicate 对 HTTP 请求进行匹配，例如请求方式、请求路径、请求头、参数等，如果请求与断言匹配成功，则将请求转发到相应的服务。
Filter（过滤器）	过滤器，我们可以使用它对请求进行拦截和修改，还可以使用它对上文的响应进行再处理。

注意：其中 Route 和 Predicate 必须同时声明。

Spring Cloud Gateway 的特征

Spring Cloud Gateway 具有以下特性：

基于 Spring Framework 5、Project Reactor 和 Spring Boot 2.0 构建。

能够在任意请求属性上匹配路由。

predicates（断言）和 filters（过滤器）是特定于路由的。

集成了 Hystrix 熔断器。

集成了 Spring Cloud DiscoveryClient（服务发现客户端）。

易于编写断言和过滤器。

能够限制请求频率。

能够重写请求路径。

Gateway 的工作流程

Spring Cloud Gateway 工作流程如下图。

图2：Spring Cloud Gateway 工作流程

Spring Cloud Gateway 工作流程说明如下：

客户端将请求发送到 Spring Cloud Gateway 上。

Spring Cloud Gateway 通过 Gateway Handler Mapping 找到与请求相匹配的路由，将其发送给 Gateway Web Handler。

Gateway Web Handler 通过指定的过滤器链（Filter Chain），将请求转发到实际的服务节点中，执行业务逻辑返回响应结果。

过滤器之间用虚线分开是因为过滤器可能会在转发请求之前（pre）或之后（post）执行业务逻辑。

过滤器（Filter）可以在请求被转发到服务端前，对请求进行拦截和修改，例如参数校验、权限校验、流量监控、日志输出以及协议转换等。

过滤器可以在响应返回客户端之前，对响应进行拦截和再处理，例如修改响应内容或响应头、日志输出、流量监控等。

响应原路返回给客户端。

总而言之，客户端发送到 Spring Cloud Gateway 的请求需要通过一定的匹配条件，才能定位到真正的服务节点。在将请求转发到服务进行处理的过程前后（pre 和 post），我们还可以对请求和响应进行一些精细化控制。

Predicate 就是路由的匹配条件，而 Filter 就是对请求和响应进行精细化控制的工具。有了这两个元素，再加上目标 URI，就可以实现一个具体的路由了。

Predicate 断言

Spring Cloud Gateway 通过 Predicate 断言来实现 Route 路由的匹配规则。简单点说，Predicate 是路由转发的判断条件，请求只有满足了 Predicate 的条件，才会被转发到指定的服务上进行处理。

使用 Predicate 断言需要注意以下 3 点：

Route 路由与 Predicate 断言的对应关系为“一对多”，一个路由可以包含多个不同断言。

一个请求想要转发到指定的路由上，就必须同时匹配路由上的所有断言。

当一个请求同时满足多个路由的断言条件时，请求只会被成功匹配的路由转发。

图3：Predicate 断言匹配

常见的 Predicate 断言如下表（假设转发的 URI 为 http://localhost:8001）。

断言

示例

说明

Path

- Path=/dept/list/**

当请求路径与 /dept/list/** 匹配时，该请求才能被转发到 http://localhost:8001 上。

Before

- Before=2021-10-20T11:47:34.255+08:00[Asia/Shanghai]

在 2021 年 10 月 20 日 11 时 47 分 34.255 秒之前的请求，才会被转发到 http://localhost:8001 上。

After

- After=2021-10-20T11:47:34.255+08:00[Asia/Shanghai]

在 2021 年 10 月 20 日 11 时 47 分 34.255 秒之后的请求，才会被转发到 http://localhost:8001 上。

Between

- Between=2021-10-20T15:18:33.226+08:00[Asia/Shanghai],2021-10-20T15:23:33.226+08:00[Asia/Shanghai]

在 2021 年 10 月 20 日 15 时 18 分 33.226 秒到 2021 年 10 月 20 日 15 时 23 分 33.226 秒之间的请求，才会被转发到 http://localhost:8001 服务器上。

- Cookie=name,c.biancheng网站站点" rel="nofollow" />

<?xml version="1.0" encoding="UTF-8"?>

server:

port: 9527 #端口号

spring:

application:

name: microServiceCloudGateway

cloud:

gateway: #路由配置

routes:

#将 micro-service-cloud-provider-dept-8001 提供的服务隐藏起来，不暴露给客户端，只给客户端暴露 API 的地址 9527

- id: provider_dept_list_routh #路由 id,没有固定规则，但，建议与服务名对应

uri: http://localhost:8001 #匹配后提供服务的路由地址

predicates:

#以下是断言条件，必选全部符条件

- Path=/dept/list/** #断言，路径匹配注意：Path 中 P 为大写

- Method=GET #只能时 GET 请求时，才能访问

eureka:

instance:

instance-id: micro-service-cloud-gateway-9527

hostname: micro-service-cloud-gateway

client:

fetch-registry: true

service-url:

defaultZone: http://eureka700网站站点" rel="nofollow" />

- Path=/dept/list/**

- Method=GET

只有当外部（客户端）发送到 micro-service-cloud-gateway-9527 的 HTTP 请求同时满足以上所有的断言时，该请求才会被转发到指定的服务端中（即 http://localhost:8001）。

3. 在 micro-service-cloud-gateway-9527 的主启动类上，使用 @EnableEurekaClient 注解开启 Eureka 客户端功能，代码如下。

package net.biancheng.c;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud网站站点" rel="nofollow"  /> 
图4：Spring Cloud Gateway 路由转发
Spring Cloud Gateway 动态路由
默认情况下，Spring Cloud Gateway 会根据服务注册中心（例如 Eureka Server）中维护的服务列表，以服务名（spring.application.name）作为路径创建动态路由进行转发，从而实现动态路由功能。

我们可以在配置文件中，将 Route 的 uri 地址修改为以下形式。
lb://service-name

以上配置说明如下：
lb：uri 的协议，表示开启 Spring Cloud Gateway 的负载均衡功能。
service-name：服务名，Spring Cloud Gateway 会根据它获取到具体的微服务地址。
示例
下面我们就通过一个实例，来展示下 Spring Cloud Gateway 是如何实现动态路由的。

1. 修改 micro-service-cloud-gateway-9527 中 application.yml 的配置，使用注册中心中的微服务名创建动态路由进行转发，配置如下。
server:
port: 9527 #端口号
spring:
application:
name: microServiceCloudGateway  #服务注册中心注册的服务名
cloud:
gateway: #路由配置
discovery:
locator:
enabled: true #默认值为 true，即默认开启从注册中心动态创建路由的功能，利用微服务名进行路由
routes:
#将 micro-service-cloud-provider-dept-8001 提供的服务隐藏起来，不暴露给客户端，只给客户端暴露 API 的地址 9527
- id: provider_dept_list_routh   #路由 id,没有固定规则，但，建议与服务名对应
uri: lb://MICROSERVICECLOUDPROVIDERDEPT #动态路由，使用服务名代替上面的具体带端口   http://eureka700网站站点" rel="nofollow"  />    
图5：Spring Cloud 实现动态路由
Filter 过滤器
通常情况下，出于安全方面的考虑，服务端提供的服务往往都会有一定的校验逻辑，例如用户登陆状态校验、签名校验等。

在微服务架构中，系统由多个微服务组成，所有这些服务都需要这些校验逻辑，此时我们就可以将这些校验逻辑写到 Spring Cloud Gateway 的 Filter 过滤器中。
Filter 的分类
Spring Cloud Gateway 提供了以下两种类型的过滤器，可以对请求和响应进行精细化控制。

过滤器类型 说明
Pre 类型 这种过滤器在请求被转发到微服务之前可以对请求进行拦截和修改，例如参数校验、权限校验、流量监控、日志输出以及协议转换等操作。
Post 类型 这种过滤器在微服务对请求做出响应后可以对响应进行拦截和再处理，例如修改响应内容或响应头、日志输出、流量监控等。

按照作用范围划分，Spring Cloud gateway 的 Filter 可以分为 2 类：
GatewayFilter：应用在单个路由或者一组路由上的过滤器。
GlobalFilter：应用在所有的路由上的过滤器。
GatewayFilter 过滤器
GatewayFilter 是 Spring Cloud Gateway 中提供的一种应用在单个或一组路由上的过滤器。它可以对单个路由或者一组路由上传入的请求和传出响应进行拦截，并实现一些与业务无关的功能，比如登陆状态校验、签名校验、权限校验、日志输出、流量监控等。

GatewayFilter 在配置文件（例如 application.yml）中的写法与 Predicate 类似，格式如下。
spring:
cloud:
gateway:
routes:
- id:               
uri:               
predicates:
- Path=              
filters:
- AddRequestParameter=X-Request-Id,1024 #过滤器工厂会在匹配的请求头加上一对请求头，名称为 X-Request-Id 值为 1024
- PrefixPath=/dept #在请求路径前面加上 /dept
……
                    
Spring Cloud Gateway 内置了多达 31 种 GatewayFilter，下表中列举了几种常用的过滤器及其使用示例。

路由过滤器 描述 参数 使用示例
AddRequestHeader  拦截传入的请求，并在请求上添加一个指定的请求头参数。 name：需要添加的请求头参数的 key；
value：需要添加的请求头参数的 value。 - AddRequestHeader=my-request-header,1024
AddRequestParameter 拦截传入的请求，并在请求上添加一个指定的请求参数。 name：需要添加的请求参数的 key；
value：需要添加的请求参数的 value。 - AddRequestParameter=my-request-param,c.biancheng网站站点" rel="nofollow"  />  
- id: provider_dept_get_routh
uri: lb://MICROSERVICECLOUDPROVIDERDEPT #使用服务名代替上面的具体带端口
predicates:
- Path=/get/**
filters:
- PrefixPath=/dept #在请求路径上增加一个前缀 /dept

2. 重启 micro-service-cloud-gateway-9527，使用浏览器访问“http://eureka700网站站点" rel="nofollow"  /> 
图6：路由过滤器示例
GlobalFilter 全局过滤器
GlobalFilter 是一种作用于所有的路由上的全局过滤器，通过它，我们可以实现一些统一化的业务功能，例如权限认证、IP 访问限制等。当某个请求被路由匹配时，那么所有的 GlobalFilter 会和该路由自身配置的 GatewayFilter 组成一个过滤器链。

Spring Cloud Gateway 为我们提供了多种默认的 GlobalFilter，例如与转发、路由、负载均衡等相关的全局过滤器。但在实际的项目开发中，通常我们都会自定义一些自己的 GlobalFilter 全局过滤器以满足我们自身的业务需求，而很少直接使用 Spring Cloud  Config 提供这些默认的 GlobalFilter。
关于默认的全局过滤器的详细内容，请参考 Spring Cloud 官网。
下面我们就通过一个实例来演示下，如何自定义 GlobalFilter 全局过滤器。

1. 在 net.biancheng.c.filter 包下，新建一个名为 MyGlobalFilter 全局过滤器配置类，代码如下。
package net.biancheng.c.filter;
import lombok.extern.slf4j.Slf4j;
import org.springframework.cloud.gateway.filter.GatewayFilterChain;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.core.Ordered;
import org.springframework.http.HttpStatus;
import org.springframework.stereotyp网站站点" rel="nofollow"  />  
2021-10-21 16:25:39.450  INFO 19116 --- [ctor-http-nio-4] net.biancheng.c.filter.MyGlobalFilter    : Thu Oct 21 16:25:39 CST 2021进入自定义的全局过滤器 MyGlobalFilter
2021-10-21 16:25:39.451  INFO 19116 --- [ctor-http-nio-4] net.biancheng.c.filter.MyGlobalFilter    : 参数 uname 不能为 null！

3. 使用浏览器访问“http://eureka700网站站点" rel="nofollow"  /> 
图7：自定义全局过滤器
随机文章
核心危机(核心危机魔石合成攻略)
风儿(风儿轻轻的吹)
饿了么红包怎么用(饿了么红包怎么用微信支付)
儿童教育文章(儿童教育)
广州4a广告公司(广州4a广告公司创意总监年薪)
抖音卡(抖音卡顿怎么解决)
xboxones(xboxone手柄怎么配对主机)
陈武简历
帆船比赛(帆船比赛视频)
海猫鸣泣之时游戏(海猫鸣泣之时游戏在哪玩)
儋州市第二中学(儋州市第二中学录取分数线)
鬼泣5攻略(鬼泣5攻略第三关怎么跳)
地球日主题(2020年世界地球日主题)
和柳亚子(和柳亚子先生于田)
冰客(冰客果汁)
yy魔兽(yy魔兽世界)
国外成人游戏(国外成人游戏注册需要visa信用卡)
拆奶罩
郭妮小说(恶魔的法则郭妮小说)
东天目山(东天目山景区)
杭同(杭同培训中心怎么样)
蝙蝠给人类的一封信(蝙蝠给人类的一封信)
大松电饭煲(美的大松电饭煲)
服饰加盟(服饰加盟店招商)
疯狂填字(疯狂填字5)
点对点短信息(点对点短信息费是什么意思)
观音普门品(观音普门品念诵全文)
河北省大运会(河北省大运会时间)
哈利波特官网(哈利波特官网在哪里)
骇客神条(骇客神条怎么辨别真假)                
                                            
        
    


    
                            
        
    




	
    
        任何透过暖茶网的网页而链接及得到之资讯、产品及服务均系用户自行发布，暖茶网对其合法性概不负责，亦不承担任何法律责任。 暖茶网站长QQ：363729367网站地图xml