gateway里的常用配置

前面的例子是通过路径（Path）方式配置路由转发，gateway还还有其他的配置，下面做个简单的介绍

1 路由 route

Route 主要由：路由id、目标uri、断言集合、过滤器集合组成。前面的实例用到了id、uri、断言。

1. id：路由标识，要求唯一，名称任意（默认值 uuid，一般不用，需要自定义）
2. uri：请求最终被转发到的目标地址
3. order： 路由优先级，数字越小，优先级越高
4. predicates：断言数组，即判断条件，如果返回值是boolean，则转发请求到 uri 属性指定的服务中
5. filters：过滤器数组，在请求传递过程中，对请求做一些修改

2 断言 predicate

断言Predicate是java8引入的新特性，它接收一个输入参数，返回布尔值结果。我们代码中也可以使用Predicate，通过Predicate可以让你的代码更加的简洁。

gateway的Predict决定了请求由哪一个路由处理。它Spring WebFlux的HandlerMapping实现。Gateway包含了很多路由断言工厂，这些工厂对HTTP请求的很多属性进行了处理，当客户端请求时，HandlerMapping会获取请求参数，并与Gateway中配置的Predicates进行比对，满足规则就按规则约定进行路由放行，否则拒绝访问或报404。源码在 org.springframework.cloud.gateway.handler.predicate 包中，感兴趣或者排查问题的时候可以阅读或跟踪。

断言是一个数组，路由下可以配置多个断言，多个断言之间是“and”关系

3 过滤器 filter

gateway在处理请求时，在路由处理之前需要经过“pre”类型的过滤器处理，处理后，在返回响应之前，可以由“post”类型的过滤器处理。微服务场景下，我们各个服务处理请求时有些事情是都要做的，比如鉴权、限流、日志输出等，这样逻辑如果写到各自的应用上会有很多重复的代码，所以可以考虑把这些功能放在gateway上。

• PRE：这种过滤器在请求路由之前调用。可以用这种过滤器实现身份验证、参数校验、权限校验、流量监控、日志输出、协议转换等、记录调试信息等。
• POST：这种过滤器在路由到微服务以后执行。可以用这种过滤器实现响应内容/响应头的修改，日志的输出，流量监控、收集统计信息等。

Gateway 过滤器从作用范围可分为两种:

• GatewayFilter：应用到单个路由或者一个分组的路由上（需要在配置文件中配置）
• GlobalFilter：应用到所有的路由上（无需配置，全局生效）

1. 局部过滤器 GatewayFilter：Gateway 中内置了许多的局部过滤器；局部过滤器需要在指定路由配置才能生效。
2. GlobalFilter 全局过滤器： GlobalFilter 的功能其实和 GatewayFilter 是相同的，只是 GlobalFilter 的作用域是所有的路由配置，而不是绑定在指定的路由配置上。多个 GlobalFilter 可以通过 @Order 或者 getOrder() 方法指定执行顺序，order值越小，执行的优先级越高。

由于过滤器有 pre 和 post 两种类型，pre 类型过滤器如果 order 值越小，那么它就应该在pre过滤器链的顶层，post 类型过滤器如果 order 值越小，那么它就应该在 post 过滤器链的底层

3. 常用过滤器规则（Filter）

过滤规则	实例	说明
StripPrefix	- StripPrefix=1	去掉URL路径中的部分前缀
PrefixPath	- PrefixPath=/app	在请求路径前加上app
RewritePath	- RewritePath=/test, /app/test	访问localhost:8000/test,请求会转发到localhost:8080/app/test
SetPath	SetPath=/app/{path}	通过模板设置路径，转发的规则时会在路径前增加app，{path}表示原请求路径
RedirectTo		重定向
RemoveRequestHeader		去掉某个请求头信息

4 常用断言（predicate）方法

4.1 Path方式

通过访问路径匹配。另一篇里写的"pattern": "/app2/**"就是path方式

4.2 Before方式

Before只接受一个时间参数，即DateTime格式时间，客户端访问Gateway接口的时间在此时间之前。当部署有访问时间限制的接口，可以使用Before、After、Between断言。

通过源码（org.springframework.cloud.gateway.handler.predicate.BeforeRoutePredicateFactory）发现，Before断言使用的时间对象是ZonedDateTime

- Path=/app2/**
- Before=2023-08-01T09:00:00[Asia/Shanghai]

4.3 After方式

与before类似，只是限定为指定时间之后

- Path=/app2/**
- After=2023-08-01T09:00:00+08:00[Asia/Shanghai]

4.4 Between方式

与before、after类似

- Path=/app2/**
- Between=2023-08-01T09:00:00+08:00[Asia/Shanghai], 2023-08-05T09:00:00+08:00[Asia/Shanghai]

4.5 Cookie方式

请求头传递了cookie并且值与gateway设置的相等。下面这个要求cookie里有some值且等于thing。

predicates:
- Cookie=some, thing

4.6 Header方式

请求头属性与设置的匹配，支持正则。下面这个要求My-Cust-Request-Id是数字串。

- Header=My-Cust-Request-Id, \d+

4.7 Host方式

根据前请求的host匹配，当前请求头中的host满足设定规则才会放行

- Path=/app1/**
- Host=localhost,**.xxx.com,127.0.0.1:8000

4.8 请求方法方式

请求方法，比如GET、POST、PUT等。

- Path=/app1/**
- Method=GET,POST

4.9 请求IP方式 RemoteAddr

用于限制允许访问接口的客户端IP网段

- RemoteAddr=192.168.1.1/24

4.10 请求参数方式 Query

请求参数与配置的相同。下面这个配置要求请求参数some=thing。

- Query=some,thing

4.10 权重Weight

Weight是用来指定当前请求被路由的权重的，其接收两个参数：分组和权重，参与权重路由的地址必须在同一个分组，否则weight无效果，权重为整型数字

- id: app1
  uri: http://127.0.0.1:81
  predicates:
    - Path=/app1/**
    - Weight=group1,9

- id: app2
  uri: http://127.0.0.1:82
  predicates:
    - Path=/app2/**
    - Weight=group1,1