Kubernetes Ingress-Nginx路径含$符号无法匹配问题求助

要正确匹配包含字面量$的路径，核心是处理NGINX对$的特殊解析逻辑——即使关闭正则匹配，$在NGINX的location规则中仍被视为行尾标记，必须通过转义才能匹配字面量。

正确的Ingress配置 #

将路径中的$用双反斜杠\\$转义（YAML中需额外转义反斜杠），同时保持use-regex: "false"，根据需求选择pathType：

精确匹配（Exact）

适用于仅匹配/api/v2/$metadata路径的场景：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: metadata-ingress
  annotations:
    nginx.ingress.kubernetes.io/enable-cors: "true"
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
    nginx.ingress.kubernetes.io/use-regex: "false"
spec:
  ingressClassName: public
  tls:
  - hosts:
    - mydomain.com
  rules:
  - host: mydomain.com
    http:
      paths:
      - path: /api/v2/\\$metadata
        pathType: Exact
        backend:
          service:
            name: busybox
            port:
              number: 8280

前缀匹配（Prefix）

适用于匹配所有以/api/v2/$metadata开头的路径（如/api/v2/$metadata/detail）：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: metadata-ingress
  annotations:
    nginx.ingress.kubernetes.io/enable-cors: "true"
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
    nginx.ingress.kubernetes.io/use-regex: "false"
spec:
  ingressClassName: public
  tls:
  - hosts:
    - mydomain.com
  rules:
  - host: mydomain.com
    http:
      paths:
      - path: /api/v2/\\$metadata
        pathType: Prefix
        backend:
          service:
            name: busybox
            port:
              number: 8280

为什么之前的方法无效 #

• 直接写/api/v2/$metadata：NGINX将$解析为行尾标记，实际匹配的是/api/v2/metadata且路径结束，与预期的/api/v2/$metadata不符。
• 使用%24metadata：NGINX在匹配前会自动解码URL，%24会被转为$，此时配置中的%24metadata会被当作字面量，与解码后的$metadata不匹配。
• 仅关闭正则未转义：即使关闭正则匹配，NGINX的location语法仍将$视为特殊字符，必须转义才能匹配字面量。

验证配置 #

应用修改后的Ingress配置后，可通过查看NGINX Ingress Controller的Pod日志或配置文件，确认生成的location规则为location = /api/v2/$metadata（精确匹配）或location /api/v2/$metadata（前缀匹配），此时即可正确转发对应路径的请求。

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