Nginx proxy_pass使用变量加尾斜杠失效问题求助

这个问题我之前帮不少人排查过，核心是Nginx处理proxy_pass的两种完全不同的逻辑——用字符串常量和用变量的时候，它的URI解析规则天差地别！

核心差异解析 #

当你使用常量写法（比如proxy_pass http://myapp:1234/）时：

• Nginx会自动匹配当前location的URI前缀，把请求中匹配到的前缀部分替换成proxy_pass末尾的路径（如果有的话）。
• 举个例子：如果你的location是/api/，请求/api/user会被自动代理到http://myapp:1234/user。

但当你使用变量写法（比如proxy_pass $upstream_proto://$upstream_app:$upstream_port/）时：

• Nginx会直接把变量拼接后的完整字符串作为目标URL，不会做任何自动的URI替换。
• 还是刚才的例子：请求/api/user会被代理到http://myapp:1234//api/user（注意这里的双斜杠和保留的/api/前缀），这显然不是你想要的，所以看起来“不生效”。

为什么加尾斜杠没用？ #

你尝试给变量加尾斜杠，但这只是给URL末尾加了一个斜杠，并没有触发Nginx的自动URI替换逻辑——这个逻辑只有在proxy_pass是纯常量的时候才会激活。

解决方法 #

要让变量写法正常工作，你需要手动控制URI的传递，常见的两种方式：

方法1：用rewrite重写URI #

通过rewrite把location匹配到的前缀去掉，再传递给后端：

location /api/ {
    set $upstream_app myapp;
    set $upstream_port 1234;
    set $upstream_proto http;
    # 把/api/开头的请求重写成去掉前缀的形式
    rewrite ^/api/(.*)$ /$1 break;
    proxy_pass $upstream_proto://$upstream_app:$upstream_port;
}

方法2：直接传递处理后的URI变量 #

利用Nginx内置的$uri变量（已经去掉了location匹配前缀的请求路径），拼到代理地址后面：

location /api/ {
    set $upstream_app myapp;
    set $upstream_port 1234;
    set $upstream_proto http;
    proxy_pass $upstream_proto://$upstream_app:$upstream_port$uri;
}

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