NGINX proxy_pass带参数转发路径时参数丢失问题排查

这个问题我之前排查过好几次，核心原因是NGINX对proxy_pass指令中同时包含路径和查询参数的处理逻辑有特殊规则。

当你在proxy_pass里同时写了具体路径（比如/old/path.html）和查询参数（?jh=twrtax2jlqs5t07d556lfhpfn3he0og）时，NGINX会优先执行路径替换操作——把请求中匹配/new/path的部分替换成/old/path.html，但会直接忽略你写在后面的查询参数，导致后端只收到了路径，没拿到jh参数。

两种靠谱的修复方案 #

方案1：用rewrite拼接完整请求URI #

这种方法逻辑最清晰，先把原请求重写成带参数的目标路径，再代理到后端：

location /new/path {
    # 精确匹配/new/path，重写成带参数的目标路径
    rewrite ^/new/path$ /old/path.html?jh=twrtax2jlqs5t07d556lfhpfn3he0og break;
    # 只指定后端服务器地址，让NGINX用重写后的完整URI代理
    proxy_pass http://IP_Address:PORT;
}

这里的break是告诉NGINX，重写完成后就停止后续的rewrite规则处理，避免多余操作。

方案2：显式拼接查询参数 #

如果需要兼容客户端可能传递的额外参数（比如用户访问domain.com/new/path?foo=bar时，要保留foo=bar同时加上你的jh参数），可以用NGINX内置变量$args来实现：

location /new/path {
    proxy_pass http://IP_Address:PORT/old/path.html?$args&jh=twrtax2jlqs5t07d556lfhpfn3he0og;
}

$args会自动获取客户端请求里的所有查询参数，用&连接你的固定参数，就能同时传递两者了。

如果确定客户端不会传额外参数，也可以直接这么写（不过还是推荐方案1，更稳妥）：

location /new/path {
    proxy_pass http://IP_Address:PORT/old/path.html?jh=twrtax2jlqs5t07d556lfhpfn3he0og;
    # 确保请求URI被完整传递
    proxy_pass_request_uri on;
}

额外提个醒 #

再帮你梳理下NGINXproxy_pass的核心规则，避免以后踩坑：

• 当proxy_pass只写后端服务器地址（不带任何路径），NGINX会把完整的请求URI（包括查询参数）原样发给后端；
• 当proxy_pass带路径时，NGINX会替换路径部分，但查询参数不会自动继承，必须显式处理。

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