Nginx 的 location 块语法不支持嵌套，所谓“嵌套”实为概念错误；正确做法是利用匹配优先级（如 =、^~、~*、/xxx）实现逻辑分层，或通过 include 拆分配置文件保持扁平结构。
Nginx 的 location 块语法上不支持嵌套——这是核心前提。你不能写这样的配置：
location /admin {
location /admin/api { # ❌ 错误！nginx -t 直接报错
proxy_pass http://api;
}
}
执行 nginx -t 会明确提示："location" directive is not allowed here
所以，“在 location 内部安全地嵌套另一层 location 逻辑”这个说法本身存在概念偏差。真正可行的是：用合法、清晰、可维护的方式，模拟或替代嵌套语义，而不是强行嵌套。
✅ 正确做法：用匹配优先级实现“逻辑分层”
Nginx 的 location 匹配天然支持层级语义，靠的是匹配顺序 + 优先级规则，而非缩进或嵌套结构。
-
=精确匹配（最高优先级） -
^~最长前缀匹配（跳过正则，高效稳定） -
~/~*正则匹配（按配置顺序，首个命中即止） -
/xxx普通前缀匹配（长度越长，优先级越高）
例如，想实现 /admin/ 下的统一鉴权，但 /admin/api/ 走代理、/admin/static/ 走本地文件：
location = /admin/login { # 精确匹配登录页
proxy_pass http://auth;
}
location ^~ /admin/static/ { # 长前缀，不走正则，高效
alias /var/www/admin/static/;
}
location ^~ /admin/api/ {
proxy_pass http://backend_api/;
}
location /admin/ { # 兜底：所有其他 /admin/ 请求
proxy_pass http://admin_ui/;
}
✅ 这不是嵌套，但实现了更可靠、更易调试的“分层路由”。
✅ 替代方案：用 include 拆分逻辑，保持扁平结构
把不同功能区域的 location 提取到独立文件中，再用 include 引入：
# 在 server 块内 include /etc/nginx/conf.d/admin.locations.conf; include /etc/nginx/conf.d/api.locations.conf; include /etc/nginx/conf.d/static.locations.conf;
每个 .conf 文件只含一组语义清晰的 location，无缩进污染，版本控制友好，多人协作不易冲突。
⚠️ 千万别踩坑：伪嵌套 + if 混用
以下写法看似“灵活”，实则危险且不可靠：
location /admin/ {
if ($arg_token = "") {
return 401;
}
if ($request_uri ~ ^/admin/api/.*) {
proxy_pass http://api;
break;
}
proxy_pass http://ui;
}
-
if在location中受限（仅部分指令允许） -
if + proxy_pass组合有已知行为异常 - 逻辑耦合重，难以复用和测试
→ 应全部替换为独立 location 块 + 合理匹配模式。
✅ 快速自查是否误写了非法嵌套
运行这两条命令：
nginx -t # 查语法错误（重点关注报错行号及前几行） grep -n "^[[:space:]]*location" /etc/nginx/sites-enabled/default # 列出所有 location 行，看是否被缩进在其它块内
配合编辑器折叠功能：如果展开一个 location 后，发现里面还藏着另一个 location（即使缩进很深），那一定是结构错了。
不复杂但容易忽略。
