在 nginx 中配置变量路径尝试,核心是使用 try_files 指令并直接引用已定义的变量。nginx 的 try_files 支持在参数列表中使用变量,它会按顺序检查每个参数对应的文件或目录是否存在。如果所有列出的路径都不存在,且最后一个参数以 = 开头,则返回该状态码;否则返回 404。

如何根据请求头或自定义变量动态选择静态资源路径
可以通过 map 模块将请求头(如 Accept-Language)映射到具体的目录变量,然后在 location 块中将该变量放入 try_files 列表。这样可以根据客户端偏好动态切换资源根路径,实现简单的多语言或多主题静态文件分发。

server {
listen 80;
server_name example.com;
# 定义语言到目录的映射
map $http_accept_language $lang_dir {
default "en";
~^zh "zh";
}
root /var/www/html;
location /static/ {
# 尝试:当前语言目录下的文件 -> 默认语言目录下的文件 -> 404
try_files /$lang_dir/$uri /en/$uri =404;
}
}
假设请求 /static/style.css 且 Accept-Language: zh-CN:
1. 检查 /var/www/html/zh/static/style.css 是否存在。
2. 若不存在,检查 /var/www/html/en/static/style.css 是否存在。
3. 若均不存在,返回 404。
如何处理 API 代理前的本地缓存文件尝试
在反向代理前,常需先检查本地是否有缓存文件。可将 $request_uri 或自定义变量拼接为缓存路径,放入 try_files。若缓存命中,直接返回文件;否则通过 proxy_pass 转发至后端。此模式常用于构建边缘缓存或 CDN 节点。

server {
listen 80;
server_name api.example.com;
set $cache_root /var/cache/api;
set $cache_path $cache_root$uri;
location /api/ {
# 尝试:本地缓存文件 -> 代理到后端
try_files $cache_path @backend;
}
location @backend {
proxy_pass http://backend_server;
}
}
假设请求 /api/data.json:
1. 检查 /var/cache/api/api/data.json 是否存在。
2. 若存在,直接返回该文件内容。
3. 若不存在,进入 @backend 位置,代理请求至 http://backend_server。
当 try_files 中变量解析失败或路径不存在时返回什么
当 try_files 中所有变量路径均不存在,且未指定 =status_code 时,Nginx 默认返回 404 Not Found。若指定了 =404,则明确返回 404 状态码及默认错误页。若变量值为空或未定义,路径解析会基于空字符串进行,通常导致 404。可通过 error_page 自定义错误响应。











