Spring Cloud Gateway 微服务网关核心解析

启动类配置

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

此时基础环境已就绪，接下来配置具体的路由逻辑。

Route Predicate Factories（路由断言）

Predicate 本质上是一个函数式接口，用于对请求参数进行校验并返回布尔值。Gateway 内置了丰富的断言工厂，我们可以直接在配置文件中利用它们定义匹配规则。

自定义断言示例

虽然官方提供了大量预置断言，但有时我们需要特定逻辑。例如，可以自定义一个实现类来校验字符串是否为空：

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

使用效果如下：

Predicate 支持组合操作，如 and（短路与）、or（短路或）、negate（取反）等。更多内置断言可参考官方文档。

配置文件中的使用

在 application.yml 中配置路由规则，通过 predicates 指定匹配条件：

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

当请求 URL 匹配 Path 规则时，网关会去注册中心获取服务地址并进行负载均衡。例如访问 http://127.0.0.1:8080/order/1，请求会被转发至 order-service。

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

我们也可以组合多个断言，比如同时限制路径和请求方法：

只有同时满足所有规则，请求才会被放行。

Gateway Filter Factories（路由过滤）

Predicate 负责'是否放行'，而 Filter 负责'放行后做什么'。Filter 可以在请求到达目标服务前或响应返回客户端前执行逻辑。

Filter 类型

• Pre/Post：Pre 在请求发送前执行，Post 在响应返回前执行。
• Global/Route：GlobalFilter 对所有路由生效，GatewayFilter 仅对特定路由生效。

添加请求参数示例

以 AddRequestParameter 为例，可以在请求头或参数中添加字段：

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

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

更多 Filter 类型可查看官方文档。

全局默认过滤器

如果希望某些逻辑对所有路由生效，可使用 default-filters：

server:
  port: 10030
spring:
  application:
    name: gateway
  cloud:
    nacos:
      discovery:
        server-addr: nacos-server:8848
    gateway:
      metrics:
        enabled: true
      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

此时配置的 Filter 将对所有路径生效。

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 即可查看监控信息：

Filter 执行顺序

当一个路由下存在多个 Filter 时，执行顺序由 Order 值决定。注意：Order 值越小，优先级越高，执行顺序越靠前。如果 Order 值相同，则遵循 default-filter > GatewayFilter > GlobalFilter 的顺序。

每个 Filter 都需指定 Order 值，官方提供的 Filter 已预设好相关值，通常无需手动调整。