nginx中root指令在多级location里是“就近覆盖”而非继承，显式定义的root会完全替代外层root，并保留uri前缀拼接路径；alias则用于剥离location前缀，末尾需加/，且仅限location内使用。
Nginx 中 root 指令在多级 location 里不是“继承”，而是“就近覆盖”：只要某一层 location 显式写了 root，它就完全替代外层（server 或 http）的 root，且保留匹配到的 URI 前缀拼接路径。
所以想用 root 在子 location 中覆盖上层路径，关键不是“怎么让它生效”，而是理解它怎么拼路径、什么时候该换 alias。
✅ 正确用法：location 内写 root 就能覆盖上层
比如：
server {
root /var/www/default;
location /admin/ {
root /opt/app/admin;
}
}
访问 /admin/js/main.js → 实际查找 /opt/app/admin/admin/js/main.js
注意：/admin/ 这个前缀被完整保留并拼在新 root 后面。
这种写法有效，但容易出错——因为开发者常以为 /admin/ 会被自动剥离。
⚠️ 常见误区：以为 root 会自动去掉 location 前缀
它不会。root 的行为是：
- 把整个请求 URI（包括匹配的前缀）直接拼到你指定的路径后面
- 不做任何截断或替换
所以以下配置会导致 404：
location /v2/ {
root /var/www/releases;
}
# 请求 /v2/index.html → 查找 /var/www/releases/v2/index.html
# 但你真正想服务的文件可能在 /var/www/releases/v2/ 目录下（即 index.html 就在 v2/ 里）
# 那么实际路径应是 /var/www/releases/v2/index.html —— 这没问题
# 但如果目录结构是 /var/www/releases/20240721/，而你想把 /v2/ 映射到那里，就错了
✅ 更安全的做法：用 alias 替代 root 来剥离前缀
当你希望 /api/ 直接映射到 /opt/backend/（即 /api/users → /opt/backend/users），必须用 alias：
location /api/ {
alias /opt/backend/;
}
注意：
-
alias路径末尾必须带/ - 它会把
/api/整个前缀替换成/opt/backend/，不重复拼接 -
alias只能在location块中使用
✅ 多级嵌套 location 的优先级规则
Nginx 按最长前缀匹配选中一个 location，只应用该块内定义的 root 或 alias：
-
location ^~ /v2/static/>location /v2/>location / - 一旦匹配到
^~ /v2/static/，里面的root或alias就生效，外层server的root完全不参与 - 没有定义
root或alias的location，才会回退到上一级（如server）的root
✅ 动态切换路径：配合 map + 变量
如果要根据域名或请求头切换根路径，推荐用 map 定义变量，再在 location 中引用：
http {
map $host $app_root {
dev.example.com /var/www/dev;
prod.example.com /var/www/prod;
default /var/www/staging;
}
server {
location / {
root $app_root;
}
location /assets/ {
alias $app_root/assets/;
}
}
}
这样既避免硬编码，又保持路径干净。
不复杂但容易忽略：root 是覆盖不是叠加，alias 才负责前缀剥离。选对指令比写多层嵌套更重要。
