nginx proxy_pass中$host值重复问题的原因与解决方法

问题解答 #

1. 错误是否由Nginx配置导致？

是的，该错误完全由当前Nginx配置的问题引发。核心原因有两点：

• 冗余的$args参数：$request_uri本身已包含完整的请求路径和查询字符串，额外追加$args会导致查询参数重复（虽不是首页$host重复的直接原因，但会引发其他潜在问题）。
• 首页路径拼接逻辑偏差：访问根路径（domain.net）时，$request_uri的值为/，结合当前配置的拼接方式，加上Nginx对变量解析的特性，最终导致$host意外重复。

2. 如何修复配置？

直接修改proxy_pass行，移除冗余的$args即可解决核心问题：

location / {
    resolver 127.0.0.11 ipv6=off;

    # 移除$args，因$request_uri已包含查询参数
    proxy_pass http://frontend:3000/$host$request_uri;

    proxy_set_header Host $http_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;
}

若需根路径目标为/domain.net（不带尾斜杠），可通过map指令预处理URI：

map $request_uri $normalized_uri {
    ~^/$ "";  # 根路径时将URI转为空字符串
    default $request_uri;
}

server {
    # ... 其他server配置 ...

    location / {
        resolver 127.0.0.11 ipv6=off;
        proxy_pass http://frontend:3000/$host$normalized_uri;

        proxy_set_header Host $http_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;
    }
}

3. 更优的实现方案

使用rewrite指令重构URI，逻辑更清晰且避免变量拼接的潜在问题：

location / {
    resolver 127.0.0.11 ipv6=off;

    # 重写URI，将域名作为第一个路径段
    rewrite ^(.*)$ /$host$1 break;

    # 固定proxy_pass地址，由Nginx自动处理URI替换
    proxy_pass http://frontend:3000;

    proxy_set_header Host $http_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规范化问题；
• 天然支持所有路径（含根路径）的正确转换，无需额外处理。

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