网关（Gateway）- 内置断言工厂

菜逼の世界

已于 2025-04-02 13:56:58 修改

阅读量1.2k

点赞数 9

分类专栏： SpringCloudAlibaba 文章标签： gateway spring cloud 内置断言工厂

于 2024-05-30 00:47:36 首次发布

本文链接：https://blog.youkuaiyun.com/u012516524/article/details/139309008

版权

SpringCloudAlibaba 专栏收录该内容

36 篇文章

订阅专栏

本文详细介绍了Spring Cloud Gateway中的内置断言工厂，包括时间断言（After、Before、Between）、Cookie断言、远程地址断言、Header断言、Host断言、Method断言、Path断言、Query断言以及路由权重断言。每个断言工厂都通过实例展示了配置和访问效果。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

时间断言工厂（ZonedDateTime.now()）

AfterRoutePredicateFactory

接收一个日期参数，判断请求日期是否在指定日期之后

路由配置

server:
  port: 8088
spring:
  application:
    name: api-gateway
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8847
        username: nacos
        password: nacos
    gateway:
      routes:
        - id: order_route # 路由唯一标识
          #uri: http://localhost:8020 # 需要转发的地址
          uri: lb://order-service # 需要转发的地址
          # 断言规则  用于路由规则的匹配
          predicates:
            - After=2024-01-01T23:00:11.518+08:00[GMT+08:00]
            # http://localhost:8088/order-serv/order/add  => http://localhost:8020/order-serv/order/add
          filters:
            - StripPrefix=1 # 转发去掉第一层路径
            # http://localhost:8020/order-serv/order/add => http://localhost:8020/order/add

访问效果

After=2024-01-01T23:00:11.518+08:00[GMT+08:00]
After=2024-01-01T23:00:11.518+08:00[Asia/Shanghai]

After=2025-01-01T23:00:11.518+08:00[Asia/Shanghai]

BeforeRoutePredicateFactory

接收一个日期参数，判断请求日期是否在指定日期之前

路由配置

server:
  port: 8088
spring:
  application:
    name: api-gateway
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8847
        username: nacos
        password: nacos
    gateway:
      routes:
        - id: order_route # 路由唯一标识
          #uri: http://localhost:8020 # 需要转发的地址
          uri: lb://order-service # 需要转发的地址
          # 断言规则  用于路由规则的匹配
          predicates:
            - Before=2024-01-01T23:00:11.518+08:00[GMT+08:00]
            # http://localhost:8088/order-serv/order/add  => http://localhost:8020/order-serv/order/add
          filters:
            - StripPrefix=1 # 转发去掉第一层路径
            # http://localhost:8020/order-serv/order/add => http://localhost:8020/order/add

访问效果

Before=2024-01-01T23:00:11.518+08:00[GMT+08:00]
Before=2024-01-01T23:00:11.518+08:00[Asia/Shanghai]

Before=2025-01-01T23:00:11.518+08:00[Asia/Shanghai]

BetweenRoutePredicateFactory

接收两个日期参数，判断请求日期是否在指定的时间段内（先小后大）

- Between=2024-01-01T23:00:11.518+08:00[Asia/Shanghai], 2025-01-01T23:00:11.518+08:00[Asia/Shanghai]

CooKie断言工厂

CookieRoutePredicateFactory

1. 接收两个参数，cookie名字和一个正则表达式

2. 判断请求cookie是否具有给定的名称且值与正则表达式匹配

- Cookie=chocolate, ch.p

远程地址断言工厂

RemoteAddrRoutePredicateFactory

接口一个IP地址段，判断请求主机地址是否在地址段中

- RemoteAddr=192.168.1.1/24

Header断言工厂

HeaderRoutePredicateFactory

1. 接收两个参数，标题名称和正则表达式

2. 判断请求Header是否具有给定的名称且值与正则表达式匹配

- Header=X-Request-Id,\d+

Host断言工厂

HostRoutePredicateFactory

接收一个参数，主机名模式，判断请求的Host是否满足匹配规则（多个逗号分隔）

- Host=**.somehost.org,**.anotherhost.org

Method断言工厂

MethodRoutePredicateFactory

接收一个参数，判断请求方法类型是否满足匹配规则（多个逗号分隔）

- Method=GET,POST

Path断言工厂

PathRoutePredicateFactory

接收一个参数，判断请求的URL部分是否满足路径的规则（多个逗号分隔）

- Path=/red/{segment},/blue/{segment}

Query断言工厂

QueryRoutePredicateFactory

1. 接收两个参数，参数名称和值正则表达式

2. 判断请求参数中是否具有给定的名称且值与正则表达式匹配

- Query=green 是否有green这个参数
- Query=red, gree. 是否有red这个参数且值匹配gree.

路由权重断言工厂

WeightRoutePredicateFactory

接收一个[组名，权重]，然后同一组内的路由按照权重转发

路由配置

spring:
  cloud:
    gateway:
      routes:
      - id: weight_high
        uri: https://weighthigh.org
        predicates:
        - Weight=group1, 8
      - id: weight_low
        uri: https://weightlow.org
        predicates:
        - Weight=group1, 2