容器与云原生 / 系统课时
配置 Path 路由
配置 Path 路由
本课解决“同一个 Host 下,不同 URL 路径如何进入不同 Service”的问题。你将用 Prefix 与 Exact 配置路径规则,并通过重叠路径验证具体请求会命中哪个后端,从而避免路径设计互相覆盖。
学习目标
- 能区分
Prefix与Exact的匹配语义 - 能配置同一 Host 下的多条 Path 规则
- 能根据请求 URL 判断实际会命中哪条规则
Prefix 与 Exact 的差异
Exact 要求请求路径与配置值完全一致。例如规则 /login 匹配 /login,但不匹配 /login/extra。Prefix 按以 / 分隔的路径元素进行前缀匹配,例如 /api 可以匹配 /api、/api/ 和 /api/users,但不会把 /apix 当作 /api 的子路径。
当同一 Host 下存在多条可匹配规则时,不应按 YAML 的书写顺序猜测结果。Ingress 规则优先选择更长的匹配路径;如果匹配路径长度相同,则 Exact 优先于 Prefix。因此应把业务上更具体的路径显式写出来,而不是依赖规则排列顺序。

配置多条路径
下面把 /api 交给 api Service,把 /login 精确交给 login Service,其余路径交给 frontend Service。假设三个 Service 都位于 default Namespace,并暴露 80 端口。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: demo-path-routing
spec:
ingressClassName: nginx
rules:
- host: app.example.test
http:
paths:
- path: /api
pathType: Prefix
backend:
service:
name: api
port:
number: 80
- path: /login
pathType: Exact
backend:
service:
name: login
port:
number: 80
- path: /
pathType: Prefix
backend:
service:
name: frontend
port:
number: 80将配置保存为 path-routing.yaml 后应用:
kubectl apply -f path-routing.yaml预期输出
ingress.networking.k8s.io/demo-path-routing created如果该 Ingress 已存在,输出可能显示为 configured 或 unchanged。这里的 / 是兜底 Prefix,而 /api 与 /login 是更具体的业务路径;兜底规则写在前后都不会改变规范定义的匹配优先级。
验证匹配结果
使用相同 Host,只改变 URL 路径。<IP> 替换为 Ingress Controller 的实际入口 IP 或可访问地址。
curl -H 'Host: app.example.test' http://<IP>/
curl -H 'Host: app.example.test' http://<IP>/api
curl -H 'Host: app.example.test' http://<IP>/api/users
curl -H 'Host: app.example.test' http://<IP>/login
curl -H 'Host: app.example.test' http://<IP>/login/extra预期结果
<frontend-service response>
<api-service response>
<api-service response>
<login-service response>
<frontend-service response>实际响应正文取决于各 Service 后端应用。/api/users 命中 /api 的 Prefix;/login/extra 不满足 /login 的 Exact,因此由 / 的 Prefix 接管。这也说明 Path 匹配不是简单的字符串开头比较,而是由 pathType 定义具体语义。
处理重叠路径与未命中问题
不要用 /app 的 Prefix 模拟“只允许一个固定 URL”。只匹配单一路径时使用 Exact;需要覆盖该路径及其子路径时使用 Prefix。如果同一 Host 下还有 /api/admin 这样的规则,它会因为匹配路径更长而优先于 /api。
还要注意,路径改写不是 Ingress 核心 Path 匹配语义本身。某些 Ingress Controller 可以通过注解或其他扩展能力修改转发给上游的路径,但这是具体控制器的行为,不应与 pathType 的匹配规则混为一谈。
当配置看似正确却没有进入预期后端时,按“Host 是否匹配 → Path 是否匹配 → Service 是否存在 → Endpoint 是否可用”的顺序检查。这样可以先确认请求是否选中了正确规则,再判断问题是否已经进入 Service 和后端可用性层面。