4. 网关路由配置：静态路由与动态路由

路由配置，说白了就是告诉网关：「这个请求该往哪儿送」。我见过不少团队，网关配得乱七八糟，结果线上出了故障，查半天发现是路由写错了。嗯，今天咱们就把这块彻底聊透。

4.1 静态路由 vs 动态路由

先搞清楚这两个概念。静态路由，就是你在配置文件里一条一条写死的路由规则。动态路由，则是通过注册中心、配置中心自动发现和更新的路由。

对比维度	静态路由	动态路由
配置方式	YAML / 配置文件硬编码	注册中心 / 配置中心动态下发
变更生效	需重启网关或重新加载	实时生效，无需重启
适用场景	测试环境、固定后端、小规模	生产环境、微服务架构、大规模
维护成本	低（规则少时）	中（需维护注册中心）
故障恢复	手动修改配置	自动摘除故障节点

4.2 路由规则定义

路由规则，核心就三要素：路由 ID、断言条件、目标 URI。拿 Spring Cloud Gateway 举例，一个典型的路由配置长这样：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          uri: lb://user-service
          predicates:
            - Path=/api/user/**
          filters:
            - StripPrefix=1
            - AddRequestHeader=X-Request-Source, gateway

这里我解释一下每个字段：

• id：路由的唯一标识，方便日志排查和监控
• uri：目标地址，可以是 http:// 固定地址，也可以是 lb:// 负载均衡地址
• predicates：断言条件，决定「什么请求匹配这条路由」
• filters：过滤器，对请求/响应做加工处理

4.3 断言工厂

断言工厂，就是用来匹配请求条件的。网关内置了很多好用的断言工厂，我挑几个最常用的说说：

断言工厂	作用	示例
Path	匹配请求路径	- Path=/api/order/**
Method	匹配 HTTP 方法	- Method=GET,POST
Header	匹配请求头	- Header=X-Token, \d+
Query	匹配查询参数	- Query=version, v1
Cookie	匹配 Cookie	- Cookie=sessionId, .*
Host	匹配域名	- Host=**.example.com
RemoteAddr	匹配客户端 IP	- RemoteAddr=192.168.1.0/24

你想想看，这些断言工厂可以组合使用。比如：

predicates:
  - Path=/api/admin/**
  - Method=POST
  - Header=X-Admin-Token, .+
  - RemoteAddr=10.0.0.0/8

这个配置的意思是：只有来自内网、携带管理员 Token 的 POST 请求，才能访问管理后台接口。多一层断言，就多一层安全。

4.4 过滤器工厂

过滤器工厂，负责对请求和响应做「加工」。我个人习惯把过滤器分成三类：

• 请求预处理：添加/修改请求头、参数、路径重写
• 响应后处理：添加/修改响应头、响应体修改
• 安全与限流：鉴权、限流、熔断

常用的过滤器工厂：

过滤器工厂	作用	配置示例
StripPrefix	去除路径前缀	- StripPrefix=1
AddRequestHeader	添加请求头	- AddRequestHeader=X-Gateway, true
AddResponseHeader	添加响应头	- AddResponseHeader=X-Powered-By, Gateway
RewritePath	路径重写	- RewritePath=/api/(?<seg>.*), /$\{seg}
RequestRateLimiter	请求限流	- name: RequestRateLimiter
Retry	请求重试	- name: Retry
CircuitBreaker	熔断降级	- name: CircuitBreaker

举个例子，假设你的后端服务接口是 /user/list，但前端请求的是 /api/user/list。这时候就需要 StripPrefix=1 把 /api 去掉。我刚开始做网关时，忘了配这个，结果后端一直报 404，查了半天才发现是路径没对齐。

4.5 路由配置的核心流程

说了这么多，咱们用一张图把整个流程串起来：

4.6 实战经验总结

最后，分享几个我在项目中积累的经验：

1. 路由顺序很重要：精确路由放前面，通配路由放后面。比如 /api/user/detail 要放在 /api/user/** 前面。
2. 断言越精确越好：能用 Path+Method 就别只用 Path。多一层断言，少一分误匹配。
3. 过滤器顺序有讲究：先做鉴权，再做限流，最后做路径重写。顺序错了，可能鉴权还没做，请求就被限流了。
4. 动态路由一定要做健康检查：我曾经遇到过注册中心里的服务已经挂了，但网关还在往那里转发。加上健康检查，自动摘除故障节点，能省很多事。