配置K8s Ingress规则后出现503 Service Not Available错误排查

问题场景 #

你需要配置test.abc.com的Ingress转发规则：

• 根路径请求转发到abc-demo-frontend-external服务
• 所有.css/.js静态文件请求转发到abc-demo-frontend服务
  但添加指定正则路径规则后出现503 Service Not Available错误，单独配置该规则时同样报错。

错误原因分析 #

1. 正则表达式不符合Nginx Ingress语法规范 #

你使用的正则/[^\/#?]+\.(?:css|js)(?![^\/?#])存在几个关键问题：

• 锚点匹配无效：浏览器不会把URL中的锚点（#部分）发送到服务器，Ingress拿到的请求URI仅包含路径和查询参数，因此正则里的#匹配逻辑完全多余。
• 环视语法兼容问题：Nginx Ingress的正则基于PCRE，但反向否定环视(?![^\/?#])属于冗余写法，且可能导致Nginx解析规则时出现异常，无法正确匹配请求路径。
• 匹配范围过窄：[^\/]限制匹配不含斜杠的字符，无法匹配带子目录的静态文件（如/static/main.js），同时这种写法可能导致Nginx无法正确识别路径规则，进而找不到对应后端服务返回503。

2. 后端服务本身不可用 #

单独配置该规则就出现503，优先排查abc-demo-frontend服务的状态：

• 确认服务是否存在：执行kubectl get svc abc-demo-frontend
• 确认服务是否有可用后端：执行kubectl get endpoints abc-demo-frontend，如果Endpoints列表为空，说明没有Pod绑定到该服务，自然会返回503。

正确配置示例 #

改用符合Nginx Ingress规范的正则，匹配所有以.css或.js结尾的路径（支持子目录）：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: test-demo-frontend-ingress
  annotations:
    kubernetes.io/ingress.class: nginx
    nginx.ingress.kubernetes.io/ssl-redirect: 'false'
    nginx.ingress.kubernetes.io/use-regex: "true"
spec:
  rules:
    - host: "test.abc.com"
      http:
        paths:
          - path: /.*\.(css|js)$
            pathType: ImplementationSpecific
            backend:
              service:
                name: abc-demo-frontend
                port:
                  number: 80
          - path: /
            pathType: ImplementationSpecific
            backend:
              service:
                name: abc-demo-frontend-external
                port:
                  number: 80

额外验证步骤 #

• 查看Nginx Ingress Controller日志，排查规则解析或转发失败的具体原因：

  kubectl logs -n <nginx-ingress-namespace> <nginx-ingress-pod-name>
  

• 测试静态文件路径：访问test.abc.com/main.js或test.abc.com/static/main.css，确认是否正常转发到目标服务。

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