Spring Cloud-Gateway服务网关

简介

Spring Cloud Gateway 为SpringBoot应用提供了API网关支持,具有强大的智能路由与过滤器功能,本文将对其用法进行详细介绍。

Gateway旨在提供一种简单而有效的方式对API进行路由,以及提供一些强大的过滤器功能,例如:熔断、限流、重试等。

Spring Cloud Gateway具有如下特性:

  • 基于Spring Framework 5,Project Reactor和Spring Boot2.0进行构建;
  • 动态路由:能够匹配任何请求属性;
  • 可以对路由指定Predicate(断言)和Filter(过滤器);
  • 集成Hystrix的断路器功能;
  • 集成Spring Cloud服务发现功能;
  • 易于编写的Predicate(断言)和Filter(过滤器);
  • 请求限流功能;
  • 支持路径重写;

相关概念

Route(路由):路由是构建网关的基本模块,它由ID、目标URI、一系列的断言和过滤器组成,如果断言为true,则匹配该路由;

Predicate(断言):指的是Java 8的Function Predicate。输入类型是Spring框架中的ServerWebExchange。这使开发人员可以匹配HTTP请求中的所有内容,例如请求头或请求参数。如果请求与断言相匹配,则进行路由;

Filter(过滤器):指的是Spring框架中的GatewayFilter的实例,使用过滤器,可以在请求被路由前后对请求进行修改。

创建api-gateway模块

这里我们创建一个api-gateway模块来演示Gateway的常用功能。

在pom.xml中添加相关依赖:

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

两种不同的配置路由方式

Gateway提供了两种不同的方式用于配置路由,一种是通过yml文件来配置,另一种是通过JavaBean来配置,下面我们分别介绍下。

使用yml配置

在application.yml中进行配置:

server:
  port: 9201

service-url:
  user-service: http://localhost:8201
spring:
  cloud:
    gateway:
      routes:
          # 路由的ID
        - id: path_routes
          # 匹配后路由的地址
          uri: ${service-url.user-service}/user/{id}
          predicates:
              # 断言,路径相匹配的进行路由
            - Path=/user/{id}

启动eureka-server、user-service和api-gateway服务。

访问网关地址:http://localhost:9201/user/1
我们发现请求被路由到了user-service的该地址上:http://localhost:8201/user/1

使用Java Bean配置

添加相关配置类,并配置一个RouteLocator对象:

@Configuration
public class GatewayConfig {

    @Bean
    public RouteLocator customerRouteLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                .route("path_route2", r -> r.path("/user/getByUsername")
                        .uri("http://localhost:8201/user/getByUsername"))
                .build();
    }

}

重新启动api-gateway服务,并调用该地址测试:http://localhost:9201/user/getByUsername?username=123

我们发现该请求被路由到了user-service的该路径上:http://localhost:8201/user/getByUsername?username=123

Route Predicate的使用

Spring Cloud Gateway将路由匹配作为Spring WebFlux HandlerMapping基础架构的一部分。Spring Cloud Gateway包括许多内置的Route Predicate工厂。所有这些Predicate都与HTTP请求的不同属性匹配。多个Route Predicate工厂可以进行组合,下面我们来介绍一些常用的Route Predicate。

注意:Predicate提到的配置都是在application-predicate.yml中进行修改,并用该配置启动api-gateway服务。

After Route Predicate

在指定时间之后的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: after_route
          uri: ${service-url.user-service}
          predicates:
            - After=2022-01-01T18:20:00+08:00[Asia/Shanghai]
            

Before Route Predicate

在指定时间之前的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: before_route
          uri: ${service-url.user-service}
          predicates:
            - Before=2022-01-01T18:20:00+08:00[Asia/Shanghai]

Between Route Predicate

在指定时间区间内的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: between_route
          uri: ${service-url.user-service}
          predicates:
            - Between=2022-01-01T18:20:00+08:00[Asia/Shanghai],2022-03-01T18:20:00+08:00[Asia/Shanghai]

Cookie Route Predicate

带有指定Cookie的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: cookie_route
          uri: ${service-url.user-service}
          predicates:
            - Cookie=username,test
            

使用curl工具发送带有cookie为username=test的请求会匹配该路由。

curl http://localhost:9201/user1 --cookie "username=test"

Header Route Predicate

带有指定请求头的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: header_route
          uri: ${service-url.user-service}
          predicates:
            - Header=X-Request-Id, \d+
            

使用curl工具发送带有请求头为X-Request-Id:123的请求可以匹配该路由。

curl http://localhost:9201/user/1 -H "X-Request-Id:123"

Host Route Predicate

带有指定Host的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: host_route
          uri: ${service-url.user-service}
          predicates:
            - Host=**.baidu.com
            

使用curl工具发送带有请求头为Host:www.baidu.com的请求可以匹配该路由。

curl http://localhost:9201/user/1 -H "Host:www.baidu.com"

Method Route Predicate

发送指定方法的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: method_route
          uri: ${service-url.user-service}
          predicates:
            - Method=GET
            

使用curl工具发送GET请求可以匹配该路由:

curl http://localhost:9201/user/1

使用curl工具发送POST请求无法匹配该路由:

curl -X POST http://localhost:9201/user/1

Path Route Predicate

发送指定路径的请求会匹配该路由。

路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: path_route
          uri: ${service-url.user-service}/user/{id}
          predicates:
            - Path=/user/{id}
            

使用curl工具发送/user/1路径的请求可以匹配该路由:

curl http://localhost:9201/user/1

使用curl工具发送/abc/1路径的请求无法匹配该路由:

curl http://localhost:9201/abc/1

Query Route Predicate

带指定查询参数的请求会匹配该路由。
路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: query_route
          uri: ${service-url.user-service}/user/getByUsername
          predicates:
            - Query=username
            

使用curl工具发送带username=test查询参数的请求可以匹配该路由:

curl http://localhost:9201/user/getByUsername?username=test

使用curl工具发送不带查询参数的请求可以匹配该路由:

curl http://localhost:9201/user/getByUsername

RemoteAddr Route Predicate

从指定远程地址发起的请求会匹配该路由。
路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: remoteaddr_route
          uri: ${service-url.user-service}
          predicates:
            - RemoteAddr=192.168.1.1/24
            

使用curl工具从192.168.1.1发起请求可以匹配该路由:

curl http://localhost:9201/user/1

Weight Route Predicate

使用权重来路由相应请求,以下表示有80%的请求会被路由到localhost:8201,20%的请求会被路由到localhost:8202。
路由匹配配置:

spring:
  cloud:
    gateway:
      routes:
        - id: weight_high
          uri: http://localhost:8201
          predicates:
            - Weight=group1, 8
        - id: weight_low
          uri: http://localhost:8202
          predicates:
            - Weight=group1, 2

Route Filter的使用

路由过滤器可用于修改进入的HTTP请求和返回的HTTP相应,路由过滤器只能指定路由进行使用。Spring Cloud Gateway内置了多种路由器,他们都由GatewayFilter的工厂类来产生,下面我们介绍下常用路由过滤器的用法。

AddRequestParameter GatewayFilter

给请求添加参数的过滤器。

spring:
  cloud:
    gateway:
      routes:
        - id: add_request_parameter_route
          uri: http://localhost:8201
          filters:
            - AddRequestParameter=username, test
          predicates:
            - Method=GET

以上配置会对GET请求添加username=test的请求参数,通过curl工具使用以下命令进行测试:

curl http://localhost:9201/user/getByUsername

相当于发起该请求:

curl http://localhost:8201/user/getByUsername?username=test

StripPrefix GatewayFilter

对指定数量的路径前缀进行去除的过滤器。

spring:
  cloud:
    gateway:
      routes:
        - id: strip_prefix_route
          uri: http://localhost:8201
          predicates:
            - Path=/user-service/**
          filters:
            - StripPrefix=2

以上配置会把以/user-service/开头的请求的路径去除两位,通过curl工具使用以下命令测试:

curl http://localhost:9201/user-service/a/user/1

相当于发起请求:

curl http://localhost:8201/user/1

PrefixPath GatewayFilter

与StripPrefix过滤器恰好相反,会对原有路径进行增加操作的过滤器。

spring:
  cloud:
    gateway:
      routes:
        - id: prefix_path_route
          uri: http://localhost:8201
          predicates:
            - Method=GET
          filters:
            - PrefixPath=/user
            

以上配置会对所有GET请求添加/USER路径前缀,通过curl工具使用以下命令进行测试。

curl http://localhost:9201/1

相当于发起该请求:

curl http://localhost:8201/user/1

Hystrix GatewayFilter

Hystrix过滤器允许你将断路器功能添加到网关路由中,使你的服务免受级联故障的影响,并提供服务降级处理。

要开启断路器功能,我们需要在pom.xml中添加Hystrix的相关依赖:

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

添加相关服务降级的处理类:

@RestController
public class FallbackController {

    @GetMapping("/fallback")
    public Object fallback() {
        Map<String, Object> result = new HashMap<>();
        result.put("data", null);
        result.put("message", "Get request fallback!");
        result.put("code", 500);
        return result;
    }

}

在application.yml中添加相关配置,当路由出错时会转发到服务降级处理的控制器上:

spring:
  cloud:
    gateway:
      routes:
        # 路由的ID
        - id: hystrix_routes
          # 匹配后路由的地址
          uri: ${service-url.user-service}
          predicates:
            # 断言,路径相匹配的进行路由
            - Method=GET
          filters:
            - name: Hystrix
              args:
                name: fallbackcmd
                fallback-uri: forward:/fallback

关闭user-service服务,调用该地址进行测试:http://localhost:9201/user/1
发现已经返回了服务降级的处理信息。
响应:{"code":500,"data":null,"message":"Get request fallback!"}

RequestRateLimiter GatewayFilter

RequestRateLimiter过滤器可以用于限流,使用RateLimiter实现来确定是否允许当前请求继续进行,如果请求量太大默认会返回HTTP 429-太多请求状态。

在pom.xml中能够添加相关依赖:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
</dependency>
    

添加限流策略配置类,这里有两种限制策略:一种是根据请求参数中的username限流,另外一种是根据访问IP进行限流;

@Configuration
public class RedisRateLimiterConfig {

    @Bean
    public KeyResolver userKeyResolver() {
        return exchange -> Mono.just(exchange.getRequest().getQueryParams().getFirst("username"));
    }


    @Bean
    public KeyResolver ipKeyResolver() {
        return exchange -> Mono.just(exchange.getRequest().getRemoteAddress().getHostName());
    }

}

我们使用Redis来进行限流,所以需要添加Redis和RequestRateLimiter的配置,这里对所有的GET请求都进行了按IP来限流的操作;

spring:
  redis:
    host: localhost
    password: 123456
    port: 6379
  cloud:
    gateway:
      routes:
        - id: requestratelimiter_route
          uri: http://localhost:8201
          filters:
            - name: RequestRateLimiter
              args:
                # 每秒允许处理的请求数量
                redis-rate-limiter.replenishRate: 1
                # 每秒最大处理的请求数量
                redis-rate-limiter.burstCapacity: 2
                # 限流策略,对应策略的Bean
                key-resolver: "#{@ipKeyResolver}"
          predicates:
            - Method=GET

logging:
  level:
    org.springframework.cloud.gateway: debug

多次请求该地址:http://localhost:9201/user/1 ,会返回状态码为429的错误;

Retry GatewayFilter

对路由请求进行重试的过滤器,可以根据路由请求返回的HTTP状态码来确定是否进行重试;

修改配置文件:

spring:
  cloud:
    gateway:
      routes:
      - id: retry_route
        uri: http://localhost:8201
        predicates:
        - Method=GET
        filters:
        - name: Retry
          args:
            retries: 1 #需要进行重试的次数
            statuses: BAD_GATEWAY #返回哪个状态码需要进行重试,返回状态码为5XX进行重试
            backoff:
              firstBackoff: 10ms
              maxBackoff: 50ms
              factor: 2
              basedOnPreviousValue: false

当调用返回500时进行重试,访问测试地址:http://localhost:9201/user/1

可以发现user-service控制台报错2次,说明进行了一次重试。

结合注册中心使用

Spring Cloud Zuul服务网关结合注册中心进行使用时,默认情况下Zuul会根据注册中心注册的服务列表,以服务名为路径创建动态路由,Gateway同样也实现了该功能。下面我们演示下Gateway结合注册中心如何使用默认的动态路由和过滤器。

使用动态路由

在pom.xml中添加依赖:

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

新增application-eureka.yml配置文件:

server:
  port: 9201
spring:
  application:
    name: api-gateway
  cloud:
    gateway:
      discovery:
        locator:
          #开启从注册中心动态创建路由的功能
          enabled: true 
          #使用小写服务名,默认是大写
          lower-case-service-id: true 
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8001/eureka/
logging:
  level:
    org.springframework.cloud.gateway: debug

使用application-eureka.yml配置文件启动api-gateway服务,访问:http://localhost:9201/user-service/user/1
可以路由到user-service的http://localhost:8201/user/1处。

使用过滤器

在结合注册中心使用过滤器的时候,我们需要注意的是uri的协议为lb,这样才能启动Gateway的负载均衡功能。

修改application-eureka.yml文件,使用了PrefixPath过滤器,会为所有GET请求路径添加/user路径并路由;

server:
  port: 9201
spring:
  application:
    name: api-gateway
  cloud:
    gateway:
      routes:
        - id: prefixpath_route
          #此处需要使用lb协议
          uri: lb://user-service 
          predicates:
            - Method=GET
          filters:
            - PrefixPath=/user
      discovery:
        locator:
          enabled: true
eureka:
  client:
    service-url: 
      defaultZone: http://localhost:8001/eureka/
logging:
  level:
    org.springframework.cloud.gateway: debug

使用application-eureka.yml配置文件启动api-gateway服务,访问http://localhost:9201/1,可以路由到user-service的http://localhost:8201/user/1处。

Gitee项目源码地址:
https://gitee.com/whwtree/springcloud-learning.git

(完)

最后修改于:2023年01月10日 00:24

添加新评论