在 nginx 中配置反向代理回退,核心做法是在 location 块内使用 try_files 指令指向一个内部 uri(如 @fallback),并在该内部 uri 中定义 proxy_pass。这样当静态文件不存在时,请求会自动转发到后端服务,而不会返回 404 错误。

try_files 如何触发内部重定向
try_files 的最后一个参数必须是内部 URI 或 404 状态码,不能直接写外部 URL。当所有列出的文件都找不到时,Nginx 会执行内部重定向到指定的 URI,从而进入下一个处理阶段。

server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
try_files $uri $uri/ @backend;
}
location @backend {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}预期结果:访问 /nonexistent.html 时,Nginx 先在磁盘查找文件,未找到则内部跳转到 @backend,最终由端口 3000 的后端应用响应。
如何处理带查询参数的动态请求
当请求包含查询参数时,$uri 变量不包含参数部分,因此 try_files 匹配的是纯路径。如果希望保留查询参数传递给后端,需要在 proxy_pass 中显式传递 $query_string 或使用默认行为。

server {
listen 80;
server_name example.com;
root /var/www/html;
location /api/ {
# 尝试匹配静态文件,失败则转发给后端
try_files $uri $uri/ @api_backend;
}
location @api_backend {
proxy_pass http://127.0.0.1:3000/api/;
# 确保查询参数被传递
proxy_set_header QueryString $query_string;
}
}预期结果:访问 /api/data?id=1 时,若 /var/www/html/api/data?id=1 文件不存在,请求将被转发至后端 http://127.0.0.1:3000/api/,且后端能接收到原始查询参数。
基于 try_files 最后参数为 404 时的具体行为
如果 try_files 的最后一个参数是 =404 或 /404.html,则不会触发反向代理。前者直接返回 404 状态码并停止处理,后者尝试加载指定的静态错误页面。这种配置适用于纯静态站点,不需要任何后端回退逻辑。


















