Kubernetes NGINX Ingress能否基于查询字符串存在性路由不同服务

NGINX Ingress控制器完全支持基于查询字符串特征的流量路由，但你当前编写的Ingress配置无法实现目标，本质是对Ingress路径匹配的范围存在误解。

你现有配置的失效原因 #

• 按照Kubernetes Ingress的官方规范，spec.rules.http.paths[].path字段的匹配范围仅覆盖URL的路径部分，也就是域名之后、第一个?之前的内容，查询字符串不属于路径的组成部分，不会参与匹配判断。
• 你在路径正则中追加的\?规则没有任何实际效果，两个路径配置本质上都是匹配/foo/bar路径。按照Ingress的路径匹配优先级，所有访问/foo/bar的请求都会先命中指向serviceA的规则，完全无法区分带不带查询串的流量。

可落地的正确实现方案 #

要实现查询字符串维度的路由，需要借助NGINX Ingress专属的配置注解，通过NGINX原生变量实现条件判断，参考配置如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
  annotations:
    nginx.ingress.kubernetes.io/configuration-snippet: |
      # 当请求携带非空查询字符串时，直接转发到serviceB的后端
      if ($args != "") {
        proxy_pass http://serviceB-8002;
        break;
      }
spec:
  rules:
  - host: xxxx.com
    http:
      paths:
      # 基础路径默认指向serviceA
      - path: /foo/bar
        pathType: Prefix
        backend:
          service:
            name: serviceA
            port:
              number: 8001
      # 占位规则：让控制器自动生成serviceB对应的upstream定义，避免proxy_pass时找不到后端
      - path: /__serviceb_placeholder
        pathType: Exact
        backend:
          service:
            name: serviceB
            port:
              number: 8002

注意事项 #

• 上述逻辑可以灵活扩展，比如需要匹配特定查询参数（如?x=10），只需要把判断条件替换为if ($arg_x = "10")即可，适配更细粒度的分流需求。
• 不要在path字段中编写任何和查询字符串相关的正则规则，这部分从规范设计上就被排除在匹配范围外，无论正则逻辑多么严谨都不会生效。

内容的提问来源于stack exchange，提问作者Michael Kobaly