Nginx缓存配置异常：无斜杠URL跳转至backend域名的修复

问题场景与配置 #

我是Nginx新手，配置静态文件缓存后遇到了URL跳转异常：

• 访问不带斜杠的地址（如https://example.com/static/folder）时，浏览器地址会跳转到http://backend:8000/static/folder/
• 访问带斜杠的地址（如https://example.com/static/folder/）时，页面正常返回，地址也保持正确

已尝试设置proxy_set_header Host $host（或直接指定为example.com），但没有效果。当前的http块配置如下：

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=static_cache:10m max_size=5g inactive=60m use_temp_path=off;

upstream backend {
    server 127.0.0.1:8000;  # Localhost
}

server { 
    listen 8000;  
    root /var/www/html;
    index index.html;  
    server_name _;  
    location / { 
        try_files $uri $uri/ =404; 
    } 
}

server {
    server_name example.com;

    location / {
        proxy_set_header Host $host; # or even proxy_set_header Host example.com
        proxy_pass http://backend/;
        proxy_cache static_cache;
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;
        add_header X-Cache-Status $upstream_cache_status;
        proxy_cache_use_stale error timeout invalid_header updating http_500 http_502 http_503 http_504;
    }

    listen 443 ssl;
    ssl_certificate /path/to/../fullchain.pem;
    ssl_certificate_key /path/to/../privkey.pem;
    include /path/to/../options-ssl-nginx.conf;
    ssl_dhparam /path/to/../ssl-dhparams.pem;
}

server {
    if ($host = example.com) {
        return 301 https://$host$request_uri;
    }
    listen 80;
    server_name example.com;
    return 404;
}

问题原因分析 #

这个跳转异常是后端Nginx（8000端口的server）返回的301重定向导致的：
当访问不带斜杠的/static/folder时，后端的try_files $uri $uri/ =404会先检查$uri对应的文件是否存在，由于folder是目录而非文件，会尝试$uri/路径，此时后端Nginx会返回301重定向到带斜杠的地址。但后端server的server_name为_，监听8000端口，它生成的重定向Location头会使用自身的监听地址（http://127.0.0.1:8000），而非前端的https://example.com，最终导致浏览器地址跳转错误。

解决方案 #

方案1：修改反向代理的重定向响应（推荐） #

在前端example.com的location /块中添加proxy_redirect指令，将后端返回的Location头中的地址替换为前端的域名和协议：

location / {
    proxy_set_header Host $host;
    proxy_pass http://backend/;
    proxy_cache static_cache;
    proxy_cache_valid 200 302 10m;
    proxy_cache_valid 404 1m;
    add_header X-Cache-Status $upstream_cache_status;
    proxy_cache_use_stale error timeout invalid_header updating http_500 http_502 http_503 http_504;
    # 新增：替换后端返回的重定向地址
    proxy_redirect http://127.0.0.1:8000/ https://example.com/;
}

如果想让配置更通用（比如后端地址变化时无需修改），可以使用变量：

proxy_redirect http://$upstream_addr/ https://$host/;

方案2：在前端直接处理不带斜杠的请求 #

在前端example.com的server块中添加rewrite规则，提前将不带斜杠的目录请求重定向到带斜杠的地址，无需转发到后端：

server {
    server_name example.com;

    # 新增：处理不带斜杠的目录请求
    rewrite ^(.*[^/])$ $1/ permanent;

    location / {
        # 原有反向代理配置...
    }

    # 原有ssl配置...
}

这个方案更高效，直接在前端完成重定向，减少了一次后端请求。

更优的静态文件缓存方案 #

当前配置中所有请求都转发到后端，但静态文件可直接由前端Nginx处理，无需走反向代理，能大幅提升性能：

1. 前端直接处理静态文件 #

在example.com的server块中添加专门的静态文件location，跳过反向代理：

server {
    server_name example.com;

    # 处理静态文件，直接返回
    location ~* \.(html|css|js|png|jpg|gif|svg)$ {
        root /var/www/html;
        expires 1h; # 设置浏览器缓存时间
        add_header Cache-Control "public, max-age=3600";
        # 如果需要用Nginx的proxy_cache缓存静态文件，可保留以下配置
        proxy_cache static_cache;
        proxy_cache_valid 200 1h;
        add_header X-Cache-Status $upstream_cache_status;
    }

    location / {
        # 原有反向代理配置...
    }

    # 原有ssl配置...
}

2. 优化缓存键 #

为避免不同协议、主机的请求共用缓存，添加自定义缓存键：

proxy_cache_key "$scheme$request_method$host$request_uri";

将这条指令添加到location /块或http块中，确保缓存的唯一性。

3. 调整缓存失效策略 #

根据静态文件的更新频率，调整proxy_cache_valid和inactive参数。比如对于不常更新的文件，可设置更长的缓存时间：

proxy_cache_valid 200 7d; # 200状态码的文件缓存7天

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