Nginx 重定向后请求参数丢失问题及解决方案

在日常开发和运维中，我们经常会遇到需要使用 Nginx 进行反向代理的场景。但在配置

proxy_pass

时，有时候可能会遇到请求参数丢失的问题。在这篇文章中，我们将会详细探讨这个问题并给出几种解决方案。

问题描述

假设我们有一个基础的 Nginx 反向代理配置，如下：

location /api/ {
  proxy_pass  https://10.76.77.27:443;
}

当我们通过 Nginx 发送一个带参数的 GET 请求时，例如

https://yourdomain.com/api/?key=value

，反向代理后的请求可能会丢失这个

key=value

参数。

原因分析

这个问题通常是因为

proxy_pass

指令在处理请求时没有将原始的查询参数（query string）传递给目标服务器。在默认情况下，Nginx 会尝试重写请求的 URI，但这样做可能会导致查询参数的丢失。

解决方案

方法一：保留原始请求 URI

要解决这个问题，最简单的方式是在

proxy_pass

指令后面加上一个

/

，这样 Nginx 会将整个请求 URI（包括查询参数）传递给被代理的服务器。

location /api/ {
  proxy_pass  https://10.76.77.27:443/;
}

方法二：使用

proxy_set_header

除了上面的方法，我们还可以通过设置

proxy_set_header

来手动传递

Host

和

Request URI

。

location /api/ {
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_pass https://10.76.77.27:443;
}

方法三：使用

rewrite

我们也可以使用

rewrite

指令来重新定义请求 URI，这样做更加灵活，但也更复杂。

location /api/ {
  rewrite ^/api(/.*)$ $1 break;
  proxy_pass https://10.76.77.27:443;
}

这里，

rewrite

指令将 URI 中的

/api

部分去掉，并将剩下的部分（包括查询参数）传递给

proxy_pass

。

小结

在 Nginx 中配置反向代理时，有多种方法可以解决请求参数丢失的问题。选择哪一种取决于具体的需求和环境。希望通过这篇文章，大家能够对这个问题有更清晰的认识，并能在实际工作中迅速解决类似问题。

如果你在实践中有其他的解决方案或者有相关的问题，欢迎在评论区或留言讨论。

下次再见！