如何在Nginx中配置带参数的REST服务路径解决404错误

云上老周

2026-9-30

Nginx REST服务路径404配置修复方案

问题根因

你当前的配置存在3个核心匹配错误：

正则^/services/abc/api/portal/transporter/[^/]+$要求transporter后面必须跟斜杠/和至少1个非斜杠字符，但你实际的访问路径中transporter后面直接跟查询参数?date=xxx，没有斜杠和后续路径，无法匹配到该location规则
Nginx的location匹配逻辑只会校验?之前的URI路径，查询参数不会参与匹配，你不需要对query部分做额外处理
如果你提到的「transporter是参数」指的是/services/abc/api/portal/后面的第一级路径是动态可变的，那你将transporter作为固定路径片段写在正则中，也会导致其他参数值无法匹配

正确配置方案

场景1：transporter是固定路径片段，无后续子路径

如果访问路径格式固定为/services/abc/api/portal/transporter加查询参数，推荐用精准匹配，性能最高：

location = /services/abc/api/portal/transporter {
    proxy_pass http://backendserver;
}

场景2：transporter是动态参数（/portal后第一级路径可变）

如果/services/abc/api/portal/后的第一级路径是动态参数（transporter只是参数的一个示例值），用如下正则匹配：

location ~ ^/services/abc/api/portal/[^/]+$ {
    proxy_pass http://backendserver;
}

场景3：需要提取动态参数传递给后端

如果需要把路径中的动态参数提取后重写传递给上游服务，可以加rewrite逻辑：

location ~ ^/services/abc/api/portal/([^/]+)$ {
    set $api_action $1;
    # 示例：将参数附加到后端请求路径，$args保留原有查询参数
    proxy_pass http://backendserver/portal?action=$api_action&$args;
}