Nginx使用变量作为proxy_pass参数出现301循环重定向问题排查

这个问题的核心在于Nginx处理proxy_pass硬编码字符串和变量的逻辑完全不同，这也是很多人踩坑的高频点：

1. 硬编码proxy_pass的行为 #

当你使用硬编码的URI（比如proxy_pass http://127.0.0.1:3031/myleaps;）时，Nginx会自动执行路径替换：

• 它会把当前location匹配到的路径前缀（这里是/myleaps），替换成proxy_pass里指定的URI路径（同样是/myleaps）。
• 举个例子：请求https://foo.de/myleaps会被代理到http://127.0.0.1:3031/myleaps；请求https://foo.de/myleaps/abc会被代理到http://127.0.0.1:3031/myleaps/abc，完全符合预期。

2. 变量形式proxy_pass的行为 #

但当你用变量（比如proxy_pass $tttt;，其中$tttt = http://127.0.0.1:3031/myleaps）时，Nginx不会做任何路径替换，而是直接将当前请求的完整$request_uri追加到变量对应的URL后面：

• 比如请求https://foo.de/myleaps时，$request_uri的值是/myleaps，所以实际代理的地址会变成http://127.0.0.1:3031/myleaps/myleaps。
• 如果你的后端服务收到/myleaps/myleaps的请求后，会重定向到标准的/myleaps路径，这就会触发浏览器的无限301循环——Nginx代理到/myleaps/myleaps，后端重定向回/myleaps，Nginx再代理到/myleaps/myleaps，反复循环。

根据你的需求（要保留变量的灵活性，同时和硬编码行为一致），有两种可靠的解决方式：

方式一：拆分变量，分离地址与路径 #

把目标地址和路径拆成两个变量，再通过rewrite处理URI，避免路径重复：

location /myleaps {
    set $target_addr http://127.0.0.1:3031;
    set $target_path /myleaps;
    # 去掉location前缀，拼接正确的代理路径
    rewrite ^/myleaps(.*)$ $target_path$1 break;
    proxy_pass $target_addr;
    # 你的proxy_set_header配置...
    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;
}

这种方式和硬编码的行为完全一致，同时保留了变量的灵活性。

方式二：直接修正变量拼接逻辑 #

如果必须把完整路径放在变量里，那需要手动处理URI，去掉重复的路径前缀：

location /myleaps {
    set $tttt http://127.0.0.1:3031/myleaps;
    # 去掉当前请求的location前缀，只保留后面的部分
    rewrite ^/myleaps(.*)$ $1 break;
    proxy_pass $tttt;
    # 你的proxy_set_header配置...
    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;
}

这里的rewrite会把/myleaps变成空字符串，把/myleaps/abc变成/abc，再拼到$tttt后面，最终代理地址就是http://127.0.0.1:3031/myleaps或http://127.0.0.1:3031/myleaps/abc。

结合你提到的Nix反向代理代码生成逻辑，你可以这样设计变量和默认proxy_pass：

1. 生成三个基础变量：

set $targetIP ${location.ip};
set $targetPort ${toString location.port};
set $targetPath ${removeSuffix "/" (toString (builtins.toPath (location.path)))};

2. 默认的proxy_pass实现，要加上URI处理逻辑：

rewrite ^${location.path}(.*)$ $targetPath$1 break;
proxy_pass http://$targetIP:$targetPort;

这样用户自定义的时候，也可以基于这三个变量灵活调整，同时不会出现路径重复导致的循环问题。

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