首页/云/Kubernetes 速查/Ingress pathType 匹配语义
本包目录(307 条)
kubectl 基础56 条工作负载36 条
网络与服务55 条
配置与存储54 条调度与资源52 条集群运维与排障54 条

Ingress pathType 匹配语义

pathType 决定路径匹配方式:Prefix 按路径元素前缀匹配、Exact 精确匹配、ImplementationSpecific 交给控制器解释;写不对会出现意外路由。

Kubernetes 速查云更新于 2026-10-12

pathType

pathType匹配规则示例
Prefix按 / 分隔的路径元素逐段匹配(/foo 匹配 /foo、/foo/bar,不匹配 /foobar)path: /api
Exact完整相等(大小写敏感)path: /health
ImplementationSpecific由控制器定义(nginx 常配合正则注解)path: /users/\d+

多路径示例

多路径示例
paths:
  - path: /api
    pathType: Prefix
    backend:
      service:
        name: api
        port:
          number: 8080
  - path: /health
    pathType: Exact
    backend:
      service:
        name: api
        port:
          number: 8080
优先级由控制器决定:nginx 控制器中长前缀的匹配优先,Exact 优先于 Prefix。

易错点

  • 不同控制器对 ImplementationSpecific 解释不同,跨控制器迁移前逐条核对
  • 把 Prefix 当成「字符串前缀」容易踩坑:/api 不匹配 /apiv2 这类非元素边界

数据来源与参考

  • Kubernetes 官方文档 · Ingress(Path types)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌