命名 location 以 @name 定义，仅作内部跳转目标；try_files 按序检查文件/目录，最后可触发 @name 实现优雅降级，如 SPA 路由或 API 回退。
Nginx 的 try_files 和命名 location 配合使用，是处理静态资源 fallback、多级路径映射和优雅降级的关键技巧。核心在于：命名 location 不参与常规匹配，只作为内部跳转目标；而 try_files 可以主动触发这种跳转，从而实现比普通正则 location 更可控的路径重定向逻辑。
理解命名 location 的作用机制
命名 location 以 @name 形式定义，它不会被请求 URI 直接匹配，只能通过 error_page、try_files 或 rewrite ... last 内部跳转调用。它的优势是完全隔离匹配逻辑，避免干扰主 location 的优先级判断。
例如：
location @fallback {root /var/www/static;
try_files /404.html =404;
}
用 try_files 触发命名 location 的典型模式
try_files 的每个参数按顺序检查：先查文件，再查目录，最后可指定一个 URI（含命名 location）作为兜底。当所有前面的路径都不存在时，Nginx 会发起一次内部重定向到该 URI —— 若是 @name，就进入对应命名块。
常见组合方式：
-
try_files $uri $uri/ @react：先找真实文件或目录，找不到就进 React 路由入口（如 SPA 的 index.html） -
try_files $uri @proxy_api：静态资源存在则直接返回，否则交由后端 API 处理 -
try_files $uri @legacy_redirect：旧路径不存在时，跳转到兼容逻辑（比如加前缀、改扩展名）
实现多层静态路径 fallback（带条件）
单个 try_files 行最多支持一个命名 location，但可通过嵌套命名 location 实现多步决策。例如：按环境变量或请求头选择不同根目录。
示例：优先尝试带版本号的静态资源，失败后降级到无版本路径，再失败则进兜底页：
location /static/ {alias /opt/app/assets/;
try_files $uri @versioned;
}
location @versioned {
# 提取原始请求中的文件名
if ($request_uri ~ ^/static/(.+)$) {
set $base $1;
}
try_files /v2/$base /v1/$base @notfound;
}
location @notfound {
return 404 "Static asset not found";
}
注意边界与常见陷阱
命名 location 中不能再用 try_files 跳回普通 location（会报错“rewrite or internal redirection cycle”），必须确保跳转链终止于文件服务、代理或明确响应。
关键细节：
-
try_files后的命名 location 前不能加斜杠，写成@name，不是/@name - 在命名 location 中使用
root时，路径拼接基于完整 URI；用alias则需注意截断逻辑，通常更推荐root - 若配合
index指令，要明确它只对$uri/形式生效，命名 location 中需显式写出文件名
