Nginx location 不支持语法嵌套，需通过最长前缀匹配、正则表达式、^~ 阻断和 = 精确匹配等机制模拟层级逻辑。
Nginx 的 location 块不支持语法嵌套，这是关键前提。你不能写成这样：
location /admin {
location /admin/settings { # ❌ Nginx 启动直接报错
proxy_pass http://backend;
}
}
错误提示会是："location" directive is not allowed here。所谓“多层嵌套”，实际是靠匹配优先级 + 路径精度 + 指令组合来模拟逻辑分层，而不是语法嵌套。
✅ 利用最长前缀匹配实现路径层级
Nginx 对所有 location 平级扫描，最终选最长、最精确的前缀匹配（或首个满足的正则）。你可以通过路径长度自然形成“隐式层级”：
-
/api/匹配所有 API 请求 -
/api/v2/更长 → 优先生效于/api/ -
/api/v2/admin/最长 → 自动覆盖前两者
示例配置：
location /api/ {
proxy_pass http://default-api;
}
location /api/v2/ {
proxy_pass http://v2-api;
}
location /api/v2/admin/ {
proxy_pass http://admin-api;
auth_request /auth/admin;
}
访问 /api/v2/admin/users 会命中第三个块，不会落入前两个——这是匹配规则决定的，不是嵌套。
✅ 用正则表达式精准捕获动态段
对含 ID、操作名等变量路径（如 /users/123/delete），前缀匹配容易过宽。改用锚定正则：
location ~ ^/api/v2/(users|posts)/\d+/(delete|update)$ {
limit_except POST { deny all; }
auth_request /auth/scope?op=$3;
proxy_pass http://backend;
}
说明：
-
^和$确保严格起止，避免误匹配/api/v2/users/123/delete-log - 捕获组
(users|posts)和(delete|update)可用于后续变量（如$1,$2） -
limit_except POST限制仅允许 POST 方法
✅ 用 ^~ 阻断正则匹配，提升效率与确定性
当某路径明确只需前缀匹配（比如静态资源），加 ^~ 可避免后续正则扫描：
location ^~ /static/ {
root /var/www/assets;
expires 1h;
}
location ~ \.js$ {
add_header X-Handled "by-js-rule";
}
访问 /static/main.js 会命中第一个块，不会进入 .js 正则块，因为 ^~ 表示“匹配成功后不再检查正则”。
✅ 用 = 实现绝对精确匹配，适合高频固定路径
location = /healthz {
return 200 "OK";
}
location = /favicon.ico {
log_not_found off;
expires 1d;
try_files /static/favicon.ico =404;
}
注意：= 只匹配完整 URI，不带查询参数。/healthz?ts=1 不会命中上面的 location = /healthz。
不复杂但容易忽略。
