容器与云原生 / 系统课时
理解规则匹配与优先级
理解规则匹配与优先级
多个 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 内,并且具体性仍完全相同,才选择列表中最先出现的规则。因此规则顺序只是最后兜底,不是普通的“先写先赢”。

用一个重叠规则验证选择结果
下面是片段示例。假设 web-gateway 和五个 Service 已存在,后端分别返回 exact、write、canary、region、api。
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:
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:
httproute.gateway.networking.k8s.io/shop-route <VALUE>
Accepted=True再用 Gateway 的实际入口地址验证,<IP> 按环境替换:
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'预期结果依次为:
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 更具体”“资源平局如何结束”分开,避免把所有字段误读成一张全局线性优先级表。