Nginx补末尾斜杠重定向时丢失请求路径前缀问题

问题分析 #

你的核心问题是：Azure Frontdoor将https://example.net/td/22-2/的请求转发到后端Nginx服务，但当用户访问无末尾斜杠的URL（如https://example.net/td/22-2/example/path）时，Nginx自动补全斜杠的重定向会丢失/td/22-2/前缀，最终跳转到https://example.net/example/path/。

这是因为Nginx默认的目录重定向逻辑仅基于自身收到的请求URI和root路径生成跳转地址，不知道Frontdoor添加的外部路径前缀；加上你设置了absolute_redirect off，Nginx返回相对路径时，浏览器会错误地将相对路径直接拼接在域名后，而非当前请求的完整路径下。

解决方案 #

方案一：手动处理目录重定向（推荐） #

关闭Nginx的自动目录重定向逻辑，手动检查请求路径是否为目录，强制添加前缀后跳转。这种方法兼容本地Docker环境和生产环境：

修改后的Nginx配置：

server {
    listen 8080;
    index  index.html index.htm;
    root   /opt/24/www;
    gzip  on;
    absolute_redirect off;

    # 动态设置前缀：本地环境为空，生产环境通过Docker环境变量传入
    set $frontend_prefix "";
    if ($env(FRONTEND_PREFIX)) {
        set $frontend_prefix $env(FRONTEND_PREFIX);
    }

    # 检查请求对应的物理目录是否存在，且URL末尾无斜杠
    if (-d $request_filename) {
        rewrite ^(.*[^/])$ $frontend_prefix$1/ permanent;
    }

    location / {
        location ~* /images/.* {
            # 可添加图片缓存规则（可选）
            expires 30d;
        }
    }
}

环境适配

• 本地Docker运行：无需额外配置，$frontend_prefix为空，重定向正常保留本地路径。
• 生产环境：启动Docker时传入环境变量，自动添加前缀：

  docker run -e FRONTEND_PREFIX=/td/22-2 [你的镜像名]
  

方案二：生成绝对URL重定向 #

如果允许Nginx返回完整的绝对URL，可开启absolute_redirect on，并配置Nginx使用Frontdoor的外部域名和协议生成正确的跳转地址：

server {
    listen 8080;
    server_name td22-2.test.net;
    index  index.html index.htm;
    root   /opt/24/www;
    gzip  on;

    absolute_redirect on;
    port_in_redirect off; # 去掉端口，适配外部HTTPS/HTTP端口

    # 从Frontdoor转发头获取外部协议和域名
    set $external_proto $scheme;
    if ($http_x_forwarded_proto) {
        set $external_proto $http_x_forwarded_proto;
    }

    set $external_host $host;
    if ($http_x_forwarded_host) {
        set $external_host $http_x_forwarded_host;
    }

    # 手动生成带前缀的绝对重定向URL
    if (-d $request_filename) {
        rewrite ^/td/22-2(.*[^/])$ $external_proto://$external_host/td/22-2$1/ permanent;
    }

    location / {
        location ~* /images/.* {
            expires 30d;
        }
    }
}

方案三：调整Frontdoor配置（如果存在路径重写） #

如果你的Frontdoor配置是将https://example.net/td/22-2/*重写为https://td22-2.test.net/*（即去掉前缀转发），那么后端Nginx收到的请求是/example/path，此时需要在Frontdoor中添加响应头重写规则：

• 将响应头中的Location: /example/path/替换为Location: /td/22-2/example/path/

这种方式无需修改后端Nginx配置，直接在Frontdoor层面修正跳转路径。

验证 #

修改配置后，重启Nginx，用curl测试：

curl -v https://example.net/td/22-2/example/path

检查返回的Location头是否为/td/22-2/example/path/（或完整的绝对URL），确认跳转路径正确。

内容的提问来源于stack exchange，提问作者Dineth-Mallawarachchi