3. 多版本路由原理：基于权重、Header、QueryParam 的路由分发机制

在 Gateway API 中，多版本路由的核心是将流量按照预定义的规则分发到不同的后端服务（Service）版本。这种分发机制主要依赖 HTTPRoute 资源中的 matches 和 backendRefs 字段。通过组合不同的匹配条件与权重分配，可以实现灰度发布、A/B 测试、蓝绿部署等高级流量管理策略。

3.1 核心概念：匹配器（Matcher）与后端引用（BackendRef）

一个 HTTPRoute 规则由两部分组成：

• 匹配器（Matches）：定义流量进入规则的条件，支持路径（Path）、Header、QueryParam、方法（Method）等。
• 后端引用（BackendRefs）：定义匹配成功后流量转发的目标 Service 及权重。

3.2 基于权重的路由分发

权重路由是最常用的灰度发布手段。它允许将流量按百分比切分到多个后端版本，无需修改客户端代码。

工作原理： 在 backendRefs 中为每个后端 Service 设置 weight 字段。Gateway 控制器会根据权重比例随机分发匹配到的请求。

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: canary-route
spec:
  parentRefs:
  - name: my-gateway
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /api
    backendRefs:
    - name: my-app-v1
      port: 80
      weight: 90
    - name: my-app-v2
      port: 80
      weight: 10

权重计算规则：

• 每个后端的实际流量比例 = 该后端权重 / 所有后端权重之和。
• 权重为 0 表示不接收流量（可用于优雅下线）。
• 权重总和不必为 100，Gateway 会自动归一化。

3.3 基于 Header 的路由分发

Header 路由允许根据请求头中的特定键值对进行流量分发。这种方式非常适合 A/B 测试，例如让内部测试人员或特定用户群体访问新版本。

匹配规则：

• type: Exact：精确匹配 Header 值。
• type: RegularExpression：正则表达式匹配 Header 值。

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: header-based-route
spec:
  parentRefs:
  - name: my-gateway
  rules:
  - matches:
    - headers:
      - name: "X-Canary"
        value: "true"
    backendRefs:
    - name: my-app-v2
      port: 80
      weight: 100
  - matches:
    - path:
        type: PathPrefix
        value: /api
    backendRefs:
    - name: my-app-v1
      port: 80
      weight: 100

3.4 基于 QueryParam 的路由分发

QueryParam 路由通过 URL 中的查询参数（如 ?version=v2）来分流。这种方式对客户端侵入性小，适合临时调试或功能验证。

匹配规则：

• type: Exact：精确匹配参数值。
• type: RegularExpression：正则表达式匹配参数值。

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: query-based-route
spec:
  parentRefs:
  - name: my-gateway
  rules:
  - matches:
    - queryParams:
      - name: "version"
        value: "v2"
    backendRefs:
    - name: my-app-v2
      port: 80
      weight: 100
  - matches:
    - path:
        type: PathPrefix
        value: /api
    backendRefs:
    - name: my-app-v1
      port: 80
      weight: 100

3.5 多条件组合路由

在实际演练中，经常需要组合多种匹配条件来实现精细化的流量控制。例如：只让携带特定 Header 且访问特定路径的请求进入新版本。

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: combined-route
spec:
  parentRefs:
  - name: my-gateway
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /api/v2
      headers:
      - name: "X-Env"
        value: "staging"
      queryParams:
      - name: "debug"
        value: "true"
    backendRefs:
    - name: my-app-v2
      port: 80
      weight: 100
  - matches:
    - path:
        type: PathPrefix
        value: /api
    backendRefs:
    - name: my-app-v1
      port: 80
      weight: 100

3.6 路由优先级与匹配顺序

当多个规则同时匹配时，Gateway API 遵循以下优先级原则：

1. 精确匹配优先于前缀匹配：Exact 类型的路径匹配优先级高于 PathPrefix。
2. 规则顺序：在同一个 HTTPRoute 中，规则按定义顺序从上到下匹配，命中即停止。
3. 条件数量：匹配条件更多的规则优先级更高（更具体）。