Spring Cloud Gateway 核心原理与实战指南

3. 启动类

创建一个标准的 Spring Boot 启动类即可：

此时网关模块已就绪，接下来配置具体的路由规则。

二、路由断言 (Route Predicate Factories)

Java 8 的 Predicate 接口常用于条件过滤。Spring Cloud Gateway 提供了丰富的断言工厂，用于匹配请求路径、方法等条件。

自定义断言

我们可以实现 Predicate 接口来定义特定逻辑。例如判断参数是否为空：

在 test 方法中编写判断逻辑：

使用效果如下：

Predicate 还支持组合操作，如 and（短路与）、or（短路或）等，方便构建复杂规则。

配置文件中的断言

我们可以在 application.yml 中直接使用内置断言，如 Path 和 Method：

gateway:
  routes:
    - id: product-service
      uri: lb://product-service
      predicates:
        - Path=/product/**
    - id: order-service
      uri: lb://order-service
      predicates:
        - Path=/order/**

配置生效后，访问 http://127.0.0.1:8080/order/1 会命中 order-service 的路由规则，网关会从注册中心获取服务地址并负载均衡转发。

若路径不匹配（如 /feign/1），则无法访问目标服务：

也可以组合多个断言，例如同时要求路径和方法匹配：

更多断言类型可参考官方文档。

三、过滤器 (Gateway Filter Factories)

断言负责'是否放行'，过滤器则负责'放行后做什么'。Filter 分为 Pre（前置）和 Post（后置），作用范围分为 Global（全局）和 Gateway（单一路由）。

添加请求参数

以 AddRequestParameter 为例，可在请求转发前注入参数：

server:
  port: 10030
gateway:
  routes:
    - id: product-service
      uri: lb://product-service
      predicates:
        - Path=/product/**
      filters:
        - AddRequestParameter=userName,bite

测试接口日志显示参数已成功注入：

默认过滤器

若需对所有路由生效，可使用 default-filters：

gateway:
  routes:
    - id: order-service
      uri: lb://order-service/
      predicates:
        - Path=/order/**
        - After=2024-03-20T00:00:22.370856700+08:00[Asia/Shanghai]
      filters:
        - AddRequestParameter=userName,bite
        - name: Custom
          args:
            name: test_custom
    - id: product-service
      uri: lb://product-service/
      predicates:
        - Path=/product/**
  default-filters:
    - name: Retry
      args:
        retries: 3
        statuses: BAD_GATEWAY

此时重试策略将对所有路由生效。

四、全局过滤器 (GlobalFilter)

Spring Cloud Gateway 内置了监控、日志等全局过滤器。启用 Actuator 即可开启指标监控：

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

配置如下：

spring:
  cloud:
    gateway:
      metrics:
        enabled: true
  management:
    endpoints:
      web:
        exposure:
          include: "*"
        endpoint:
          health:
            show-details: always
          shutdown:
            enabled: true

访问 /actuator 即可查看监控信息：

五、过滤器执行顺序

当一个路由下存在多个过滤器时，执行顺序取决于 Order 值。Order 值越大，执行越靠前。若 Order 相同，则遵循 default-filter > GatewayFilter > GlobalFilter 的顺序。

理解这一机制有助于调试复杂的请求处理流程。