Nginx Ingress Controller修改路径为/api/后请求异常问题咨询

问题根源 #

你把Ingress的path改成/api/后出现请求失效，核心是两个问题：

1. 路径匹配规则不匹配：Nginx Ingress的Prefix类型匹配/api/时，只会命中以/api/开头的请求（比如/api/xxx），而你访问的http://localhost/api/v1/users路径是/api后直接跟v1，不符合/api/的前缀规则，因此根本没被这个Ingress规则匹配到，返回错误。
2. 重写逻辑不对应：即使你访问http://localhost/api/api/v1/users（符合/api/前缀），当前rewrite-target: /会把整个匹配的/api/前缀替换成/，最终转发给后端的路径是/api/v1/users，但你的后端服务原本期望的是/v1/users，所以也会报错。

正确配置方案 #

需要结合正则捕获组来实现路径的正确匹配与重写，修改后的Ingress配置如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: some-ingress
  annotations:
    kubernetes.io/ingress.class: "nginx"
    nginx.ingress.kubernetes.io/service-upstream: "true"
    # 用捕获组保留/api/之后的路径部分，重写时拼接到根路径后
    nginx.ingress.kubernetes.io/rewrite-target: /$1
    nginx.ingress.kubernetes.io/enable-cors: "true"
    nginx.ingress.kubernetes.io/cors-allow-origin: "http://localhost"
    nginx.ingress.kubernetes.io/cors-allow-methods: "PUT, GET, POST, OPTIONS, DELETE"
    nginx.ingress.kubernetes.io/cors-allow-headers: "DNT,X-CustomHeader,X-LANG,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,X-Api-Key,X-Device-Id,Access-Control-Allow-Origin"
spec:
  rules:
  - http:
      paths:
        - path: /api/(.*)
          pathType: Prefix
          backend:
            service:
              name: backend-svc
              port:
                number: 80

配置说明 #

• path: /api/(.*)：通过正则捕获组匹配所有以/api/开头的请求，(.*)会捕获/api/之后的全部路径内容（比如请求/api/v1/users时，捕获到v1/users）。
• rewrite-target: /$1：将转发路径重写为/加上捕获到的内容，最终后端收到的路径是/v1/users，和你之前path: /时的逻辑完全一致，确保服务能正确响应。

额外注意 #

• 避免给path加结尾斜杠，Prefix匹配对斜杠敏感，/api/和/api是两种不同的匹配规则，前者仅匹配带后续斜杠的路径，后者匹配所有以/api开头的路径。
• 如果不需要保留/api前缀的转发逻辑，也可以直接用path: /api配合rewrite-target: /，但这种方式在复杂路径场景下容易出现重复斜杠问题，使用正则捕获组是更可靠的方案。

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