nginx 的 location 指令不支持语法嵌套，所有 location 必须直接定义在 server 块内；可通过优先级规则（=、^~、最长前缀匹配、正则顺序）模拟嵌套逻辑，并借助命名 location 实现逻辑跳转。
Nginx 的 location 指令本身不支持语法上的嵌套——你不能在某个 location 块内部再写一个 location 块。所谓“嵌套路径”，实际是指通过合理设计多个并列的 location 规则，实现对同一根路径下不同子路径的精细化控制，达到逻辑上“层层细化”的效果。
为什么 location 不能真正嵌套？
Nginx 配置解析是扁平化的：所有 location 必须直接定义在 server 块（或另一个 location 的上级 server）内。配置文件中若出现如下写法，会直接报错：
location /api/ {
proxy_pass http://backend;
location /api/v2/ { # ← 这里不被允许
proxy_pass http://v2_backend;
}
}
怎么实现“嵌套路径”的等效效果？
靠优先级 + 精确顺序 + 修饰符组合来模拟嵌套逻辑。关键是让更具体的规则优先匹配，避免被宽泛规则“吃掉”。
-
用
=处理绝对精确路径，如location = /health，它永远最高优先级，不会被其他规则干扰 -
用
^~锁定前缀且阻止正则匹配继续，例如location ^~ /static/匹配所有以/static/开头的请求，并跳过后续正则检查，适合静态资源兜底 -
把更长、更具体的前缀放在前面，Nginx 对无修饰符或
^~的前缀匹配，取的是最长匹配，所以location /api/v2/users应写在location /api/之前，否则后者会先命中 -
正则匹配（
~或~*）按配置顺序扫描，一旦命中即停止，因此要把高优先级的正则写在前面；注意它默认比前缀匹配低一级，除非加^~提前终止
典型场景：API 版本路径分发
想让 /api/v1/xxx 走旧服务，/api/v2/xxx 走新服务，其余 /api/ 请求返回 404：
location ^~ /api/v2/ {
proxy_pass http://v2_backend/;
}
location ^~ /api/v1/ {
proxy_pass http://v1_backend/;
}
location ^~ /api/ {
return 404;
}
这里三个都是 ^~ 前缀匹配，Nginx 会选最长的（如请求 /api/v2/users → 匹配第一行），天然形成“路径层级感”。
配合命名 location 实现逻辑跳转
虽然不能嵌套，但可用 error_page 或 try_files 跳转到命名 location（以 @ 开头），实现条件分支效果：
location /admin/ {
try_files $uri @admin_fallback;
}
location @admin_fallback {
proxy_pass http://admin_app;
include proxy_params;
}
这不算嵌套，但提供了类似“子路由处理器”的解耦能力。
