Backend Route与Ingress/Nginx路由冲突致API调用路径异常求助

你的问题核心是Ingress路径转发规则和后端API路由前缀叠加导致的路径重复：

• 后端.NET控制器已设置/api/management路由前缀，接口实际路由为/api/management/XXXX；
• 当前Ingress转发/api/management/XXXX时，会把完整路径传给后端，导致后端尝试匹配/api/management/api/management/XXXX（控制器前缀+转发路径），因此返回404；而请求/api/management/api/management/XXXX时，转发路径与后端前缀拼接后刚好匹配，所以能正常响应。

解决方案1：修正Ingress路径重写规则（推荐） #

调整Ingress的正则路径与rewrite-target注解，让Ingress仅转发/api/management后的部分内容，配合后端路由前缀实现正确匹配。

修改后的Ingress配置示例：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$1
spec:
  rules:
    - host: your-domain.com
      http:
        paths:
          # 后端API路由：优先匹配更具体的路径，避免被UI路由拦截
          - path: /api/management/(.*)
            pathType: ImplementationSpecific
            backend:
              service:
                name: your-api-service
                port:
                  number: 80
          # UI单独路由：精确匹配/management路径
          - path: /management
            pathType: Exact
            backend:
              service:
                name: management-ui-service
                port:
                  number: 80
          # UI兜底路由：匹配所有未被前面规则覆盖的路径，放在最后
          - path: /(.*)
            pathType: ImplementationSpecific
            backend:
              service:
                name: management-ui-service
                port:
                  number: 80

关键说明：

• path: /api/management/(.*)：用正则捕获/api/management/之后的所有内容（如XXXX）；
• rewrite-target: /$1：将转发给后端的路径重写为捕获到的内容（即/XXXX），与后端/api/management前缀拼接后，正好匹配接口路由/api/management/XXXX；
• 路径顺序必须遵循具体路由在前，兜底路由在后，确保API请求不会被UI路由匹配。

解决方案2：调整后端.NET控制器路由前缀 #

若不想改动Ingress，可直接去除后端控制器的/api/management前缀，在接口方法上定义完整路由：

// 原配置
[Route("api/management")]
[ApiController]
public class ManagementController : ControllerBase
{
    [HttpGet("XXXX")]
    public IActionResult GetXXXX()
    {
        // 业务逻辑
    }
}

// 修改后
[ApiController]
public class ManagementController : ControllerBase
{
    [HttpGet("api/management/XXXX")]
    public IActionResult GetXXXX()
    {
        // 业务逻辑
    }
}

此方式适合Ingress配置无法修改的场景，但接口数量较多时修改成本较高。

验证方法 #

修改Ingress配置后，执行以下命令更新配置：

kubectl apply -f your-ingress.yaml

随后测试http://domain/api/management/XXXX，即可正常访问后端接口。

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