@符号定义的命名location是Nginx专用于内部跳转的逻辑锚点，不可被客户端访问，仅通过try_files、error_page或rewrite break等指令触发，用于封装复用代理、PHP执行或fallback等配置逻辑。
@ 符号定义的命名 location 是 Nginx 内部跳转的核心机制，它不对外暴露、不参与 URI 匹配，只作为逻辑锚点被 try_files、error_page 或 rewrite ... break 等指令静默调用。它的本质不是“路径”，而是配置内的可复用处理块。
命名 location 的写法与限制
必须严格以 @ 开头，后接合法标识符（字母、数字、下划线），不能含斜杠、空格或特殊符号：
- ✅ 正确：
location @php { fastcgi_pass unix:/var/run/php.sock; } - ✅ 正确：
location @proxy_api { proxy_pass http://api_backend; } - ❌ 错误：
location /@php { ... }—— 变成普通 location，可能被外部访问 - ❌ 错误：
location @fallback/ { ... }——@后不能跟/ - ❌ 错误：
location @404 { return 200 "Not found"; }却期望浏览器直接访问/@404—— 它不会响应任何外部请求
怎么触发命名 location 的内部跳转
命名 location 不会自动执行，必须由特定指令显式调用。常见方式有三种：
-
用
try_files做 fallback：先尝试静态文件，失败后跳转到命名 location
例如：try_files $uri $uri/ @index;→ 找不到文件就交由@index返回index.html（适合 Vue/React 单页应用） -
用
error_page统一错误处理：把 HTTP 错误静默导向命名 location
例如：error_page 404 @notfound;+location @notfound { return 404 "Custom 404 page"; } -
用
rewrite ... break配合命名 location 复用代理逻辑
例如：rewrite ^/v1/(.*)$ /api/$1 break;后接proxy_pass http://backend;，可优化为封装进@api_proxy，再统一调用
为什么不能直接访问 @name？这是设计，不是 bug
Nginx 自动将所有 location @xxx 视为 internal，禁止外部请求。访问 http://example.com/@php 必然返回 404 —— 这是安全机制，防止逻辑块被绕过或滥用。不需要手动加 internal; 指令，加了反而冗余。
典型实用场景举例
一个常见且高效的组合用法：
- 前端项目部署时，用
try_files $uri $uri/ @spa;确保所有非资源请求都落到index.html - PHP 应用中，把 FastCGI 公共配置抽到
@php，多个 location 共享：location ~ \.php$ { try_files $uri @php; }+location @php { fastcgi_pass ...; include fastcgi_params; } - API 路由统一代理：所有
/api/下请求经 rewrite 标准化后，统一交由@api_backend处理，避免重复写proxy_set_header等参数
