nginx 的 location 指令不支持语法嵌套，但可通过前缀匹配顺序、正则表达式捕获及 internal 命名 location 等方式等效实现路径层级处理与逻辑分层。
Nginx 的 location 指令本身不支持语法意义上的“嵌套”，即你不能在某个 location 块内部再写一个 location 块。这是 Nginx 配置的硬性限制，配置会直接报错。但实际业务中常需要实现“路径层级匹配”或“不同子路径差异化处理”，可以通过合理设计 location 顺序、前缀匹配、正则匹配和 alias/root 配合来等效达成目标。
用前缀匹配模拟“嵌套”逻辑
利用 location 的最长前缀匹配规则，按路径层级由长到短书写，Nginx 会自动选中最精确的匹配项：
-
location /api/v2/users/会优先于location /api/ -
location /admin/dashboard/不会受location /admin/干扰，只要它写在前面或长度更长（注意：纯前缀匹配只看字符串长度，不看语义）
示例：
location /app/ {
proxy_pass http://backend1;
}
location /app/static/ {
alias /var/www/static/;
}
location /app/api/v3/ {
proxy_pass http://api-v3-backend/;
}这里三个 location 是平级的，但因路径长度和匹配精度差异，请求 /app/static/logo.png 会命中第二个，而非第一个。
用正则 location 处理动态子路径
当需要捕获路径参数或匹配复杂模式（如 /user/123/profile），可用 ~ 或 ~* 正则匹配，并配合 $1、$2 引用捕获组：
-
~ ^/api/(v\d+)/(.+)$可提取版本号和后续路径 - 搭配
proxy_pass时注意结尾斜杠，避免路径拼接错误
示例：
location ~ ^/api/(v\d+)/users/(.+)$ {
proxy_set_header X-API-Version $1;
proxy_pass http://user-api/$1/users/$2;
}用 internal + named location 实现内部跳转
虽然不能嵌套，但可通过 internal 限定的命名 location（以 @ 开头）做内部重定向，实现逻辑分层：
- 主
location处理入口判断，用error_page 404 = @fallback或try_files转交 -
@fallback中统一处理静态资源、API 降级或日志记录等
示例：
location / {
try_files $uri $uri/ @backend;
}
location @backend {
internal;
proxy_pass http://app-server;
}常见误区提醒
容易误以为能这样写（❌ 错误）：
location /admin/ {
auth_basic "Admin Area";
location /admin/api/ { # ← Nginx 会报错：invalid directive "location"
proxy_pass http://admin-api;
}
}正确做法是拆成两个独立 location，并确保权限、代理、缓存等指令各自设置：
location /admin/ {
auth_basic "Admin Area";
alias /var/www/admin/;
}
location /admin/api/ {
auth_basic "Admin Area";
proxy_pass http://admin-api/;
}注意：使用 alias 时末尾斜杠必须与 location 匹配一致；proxy_pass 后带斜杠可截断前缀，不带则原样拼接。
