秒懂SpringCloud Gateway路由配置详解

2024-01-03 05:55:56

解锁 Gateway 路由：掌控流量流向

Spring Cloud Gateway 赋予您强大的能力，让您驾驭 API 管理、负载均衡、安全和监控等关键任务。在这场探索中，我们将深入探究 Gateway 路由的奥秘，帮助您高效地将请求引导至您的后端服务。

直达目的地：转发到指定服务

让我们从最基本的路由配置入手：将请求转发到指定的服务。只需指定目标服务的 URI，您的请求便会无缝抵达：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          uri: http://localhost:8081

如此一来，所有请求都将转交给端口 8081 上名为 user-service 的服务。

指定路径：精准定位

如果您希望请求只命中特定路径，请使用 path 属性。例如：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          path: /user/**
          uri: http://localhost:8081

此配置巧妙地将所有以 /user/ 开头的请求都发送至 user-service。

断言条件：按需筛选

断言充当守门人，根据您指定的条件筛选请求。使用 predicates 属性添加断言：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          predicates:
            - Path=/user/**
          uri: http://localhost:8081

只有路径匹配 /user/ 的请求才能跨越此断言，继续前行。

路由过滤器：巧妙处理

路由过滤器如同多功能工具，可用于修改请求或响应。通过 filters 属性，您可以添加过滤器：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          filters:
            - StripPrefix=1
          uri: http://localhost:8081

此配置会将请求路径中的第一个前缀去掉，再将请求转发到 user-service。

负载均衡：均匀分发

Gateway 支持多种负载均衡算法，让您的请求在后端服务间均衡分布。使用 loadbalancer 属性指定算法：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          loadbalancer: RoundRobin
          uri: http://localhost:8081

轮询算法将依次将请求分配给 user-service 的实例。

超时设置：把握时间

Gateway 提供了超时设置，避免请求陷入无限等待。使用 timeout 属性设定超时时间：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          timeout: 3000
          uri: http://localhost:8081

3 秒后，如果请求仍未得到响应，网关将终止等待并返回错误。

熔断器：应对突发

熔断器充当安全阀，防止后端服务因大量失败请求而崩溃。通过 circuitbreaker 属性配置熔断器：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          circuitbreaker:
            name: user-service-circuitbreaker
            enabled: true
            threshold: 5
            sleepWindow: 10000
            halfOpenEnabled: true
          uri: http://localhost:8081