You need to enable JavaScript to run this app. Azure AKS下Nginx Ingress正则路径路由失效,无法转发至Ocelot网关
优惠活动
大模型
产品
解决方案
定价
更多

Azure AKS下Nginx Ingress正则路径路由失效,无法转发至Ocelot网关

AKS Ingress正则路由失效定位与配置修正

核心失效原因排查

当前正则规则完全不生效,主要来自三类硬配置错误,叠加AKS托管Ingress组件的兼容特性导致:

  • 元数据字段拼写错误:原配置将annotations写为anotations,这个拼写错误会导致所有nginx类正则、重写相关的注解被IngressController完全忽略,正则开关根本没有被触发,自然所有正则规则不生效。
  • 捕获组与重写目标不匹配:原配置中路径正则/gateway(/|$)(.*)定义了两个捕获组,其中$1匹配斜杠或路径结束符,$2匹配/gateway后面的全量子路径,但原配置的rewrite-target: /$1会把转发给后端的路径替换成无意义的分隔符,就算正则生效也会出现路径不匹配的404错误。
  • 路径类型兼容问题:AKS附带的HTTP应用路由托管组件,基于的旧版nginx ingress实现中,ImplementationSpecific类型的正则路径存在已知兼容bug,无法正常加载用户定义的正则表达式。

架构设计思路修正

使用Ocelot作为统一API网关的设计是完全合理的,只需要调整不必要的暴露规则:

  • 不需要为userservice等后端服务配置独立的公网Ingress路由,所有后端服务只需要保证集群内部DNS解析正常,可被Ocelot服务访问即可,减少不必要的公网暴露面。
  • Ingress层只承担公网流量入口、统一TLS卸载的职责,所有路由分发、鉴权、流量控制规则全部交给Ocelot网关处理,避免Ingress和Ocelot两层的路径规则冲突。

可正常运行的修正配置

适配AKS托管Ingress、匹配现有Ocelot路由规则的Ingress配置如下:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ocelot-gateway
  namespace: ocelot-ns
  annotations:
    kubernetes.io/ingress.class: addon-http-application-routing
    nginx.ingress.kubernetes.io/ssl-redirect: "false"
    # 显式开启正则匹配能力
    nginx.ingress.kubernetes.io/use-regex: "true"
    # 重写目标拼接为Ocelot可识别的完整路径
    nginx.ingress.kubernetes.io/rewrite-target: /gateway/$2
spec:
  rules:
    - http:
        paths:
          # 匹配所有/gateway开头的任意子路径
          - path: /gateway(/|$)(.*)
            # 替换为Prefix类型,规避旧版nginx ingress的兼容bug
            pathType: Prefix
            backend:
              service:
                name: ocelot
                port:
                  number: 80

配置逻辑说明

  • 正则路径/gateway(/|$)(.*)会匹配所有以/gateway为前缀的请求,不管后面接多少层子路径都可以被命中。
  • 重写目标/gateway/$2会将捕获到的/gateway后的全量子路径,拼接成Ocelot可识别的完整路径(例如公网请求/gateway/api/test会被重写为/gateway/api/test,完全匹配现有Ocelot配置的UpstreamPathTemplate规则,不会出现路由不匹配问题)。
  • 将pathType从ImplementationSpecific替换为Prefix,是AKS托管Ingress官方验证过的可兼容正则的组合,不会出现正则规则不加载的问题。

落地验证步骤

  • 检查Ingress配置加载状态:执行kubectl describe ingress ocelot-gateway -n ocelot-ns,确认事件列表中没有注解解析失败的提示。
  • 公网路由功能测试:从集群外访问http://<你的AKS应用路由公网域名>/gateway/api/test,如果能返回userservice的正常响应,说明正则路由已经正常工作。
  • 安全规则收敛:删除原配置中Ingress B的公网路由,避免请求绕过Ocelot网关直接访问后端服务,符合统一网关的设计目标。

内容的提问来源于stack exchange,提问作者user1598696

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 16:45:04