容器与云原生 / 系统课时

理解规则匹配与优先级

理解规则匹配与优先级

多个 HTTPRoute 或同一 Route 的规则发生重叠时,流量去向不能靠 YAML 顺序猜。本课把“是否命中”“match 具体性”和“跨 Route 平局消解”拆开,并用一组重叠规则验证 Path、Method、Header 与 Query 的选择结果。

学习目标

  • 判断同一个 HTTPRoute 内多个 rules、matches 同时命中时如何选择
  • 区分 match 具体性与跨 HTTPRoute 的资源级平局消解
  • 用配置验证 Path、Method、Header 与 Query 的重叠结果

先把同 Route 的匹配说清

单个 match 中的 Path、Method、Header、Query 条件是 AND 关系;同一规则中的多个 matches 是 OR 关系。先判断条件是否满足,未命中的 match 不参与后续比较。

多个 match 已命中时,才继续比较具体性:Exact Path 优先;否则比较最长 PathPrefix;路径仍相同才看 Method,之后再比较 Header 匹配数量和 Query 参数匹配数量。后面的条件只用于解决前一步留下的平局,不能反过来压过更具体的路径。正则路径之间的相对优先级由实现决定。

如果平局只发生在同一个 HTTPRoute 内,并且具体性仍完全相同,才选择列表中最先出现的规则。因此规则顺序只是最后兜底,不是普通的“先写先赢”。

HTTPRoute 多规则匹配与优先级决策流程

用一个重叠规则验证选择结果

下面是片段示例。假设 web-gateway 和五个 Service 已存在,后端分别返回 exact、write、canary、region、api。

yaml
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: shop-route
spec:
  parentRefs:
    - name: web-gateway
  hostnames:
    - shop.example.com
  rules:
    - matches:
        - path:
            type: Exact
            value: /api/orders
      backendRefs:
        - name: exact-svc
          port: 80
    - matches:
        - path:
            type: PathPrefix
            value: /api
          method: POST
      backendRefs:
        - name: write-svc
          port: 80
    - matches:
        - path:
            type: PathPrefix
            value: /api
          headers:
            - type: Exact
              name: env
              value: canary
      backendRefs:
        - name: canary-svc
          port: 80
    - matches:
        - path:
            type: PathPrefix
            value: /api
          queryParams:
            - type: Exact
              name: region
              value: us
      backendRefs:
        - name: region-svc
          port: 80
    - matches:
        - path:
            type: PathPrefix
            value: /api
      backendRefs:
        - name: api-svc
          port: 80

保存为 httproute.yaml 后应用,并等待该父引用下的 Accepted 条件变为 True:

bash
kubectl apply -f httproute.yaml
until kubectl get httproute shop-route -o jsonpath='{.status.parents[0].conditions[?(@.type=="Accepted")].status}' | grep -qx True; do
  sleep 2
done
echo 'Accepted=True'

预期输出如下,<VALUE> 通常是 created 或 configured:

text
httproute.gateway.networking.k8s.io/shop-route <VALUE>
Accepted=True

再用 Gateway 的实际入口地址验证,<IP> 按环境替换:

bash
curl -s -H 'Host: shop.example.com' 'http://<IP>/api/orders'
curl -s -X POST -H 'Host: shop.example.com' -H 'env: canary' 'http://<IP>/api/items?region=us'
curl -s -H 'Host: shop.example.com' -H 'env: canary' 'http://<IP>/api/items?region=us'
curl -s -H 'Host: shop.example.com' 'http://<IP>/api/items?region=us'
curl -s -H 'Host: shop.example.com' 'http://<IP>/api/items'

预期结果依次为:

text
exact
write
canary
region
api

五个结果依次体现 Exact Path、Method、Header、Query 和普通前缀规则的选择。关键点是:只有前面的比较维度打平,后面的维度才参与。

跨 HTTPRoute 时再加入资源级平局

跨 HTTPRoute 不能从 creationTimestamp 开始比较。多个 HTTPRoute 的 hostname 相交时,先比较匹配 hostname 的具体性:非通配符字符更多者优先,再比较总字符数;hostname 仍打平,才继续比较前面的 HTTPRouteMatch 具体性。

只有 match 仍完全相同且平局横跨多个 HTTPRoute,才比较资源:先选创建时间更早的 Route;时间相同再按 namespace/name 字典顺序。若胜出的 Route 内还有同等最高优先级规则,才使用该 Route 中最先出现的规则。

例如,新 Route A 使用 Exact /api/orders,旧 Route B 只有 PathPrefix: /api,请求仍由 A 处理;B 更早创建不会覆盖更具体的 match。只有 hostname 与 match 都打平时,创建时间才参与决胜。

排查冲突时按层收集证据

先记录真实请求的 Host、Path、Method、Header 和 Query,再确认 Listener、Route 附着状态与 hostname 候选范围;随后只比较真正命中的 match;最后才检查跨 Route 的创建时间、namespace/name,或同 Route 内的规则顺序。

这样能把“条件是否成立”“哪个 match 更具体”“资源平局如何结束”分开,避免把所有字段误读成一张全局线性优先级表。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

理解规则匹配与优先级

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通