Nginx 如何在 Location 块中局部覆盖 Root 指令实现多站点目录隔离

Nginx 多站点目录隔离应使用独立 server 块而非 location + root：因 root 在 location 中会覆盖并拼接 URI 导致路径错误；推荐基于域名或端口配置多个 server 块，语义清晰、互不影响；若必须同域名下路径隔离，则用 alias + 精确 location + try_files，并注意 alias 末尾斜杠。

在 Nginx 中，location 块不能“局部覆盖” root 指令来实现多站点目录隔离——这是个常见误解。root 指令在 location 中不是“局部生效”，而是完全替代 server 级 root，并保留 URI 前缀，容易导致路径错位和 404。真正安全、清晰、可维护的多站点目录隔离，靠的是独立 server 块 + server_name 匹配，而非在一个 server 内用多个 location + root 拼凑。

为什么 location + root 不适合多站点隔离

root 在 location 中的行为是“作用域覆盖”，不是“路径微调”：

1. server { root /var/www/siteA; } → 访问 / → /var/www/siteA/index.html
2. location /siteB/ { root /var/www/siteB; } → 访问 /siteB/app.js → 实际找的是 /var/www/siteB/siteB/app.js（多了一层 siteB/）
3. 想让 /siteB/ 映射到 /var/www/siteB/ 下所有内容？必须用 alias，但 alias 仅支持单路径前缀替换，不支持嵌套或通配，且与 try_files、index 配合易出问题

正确做法：用多个 server 块按域名或端口隔离

这才是 Nginx 原生支持、语义清晰、运维友好的方式：

1. 基于域名（推荐）：每个站点独占一个 server 块，靠 Host 头区分

   server { listen 80; server_name site1.com; root /var/www/site1; index index.html; }

   server { listen 80; server_name site2.com; root /var/www/site2; index index.html; }

2. 基于端口（测试友好）：不同端口绑定不同 root

   server { listen 8081; root /var/www/app1; index index.html; }

   server { listen 8082; root /var/www/app2; index index.html; }

3. 所有 server 块互不影响，日志、SSL、限流等配置均可独立设置，无继承干扰

如果必须共用一个域名+路径前缀（如 /app1/, /app2/）

那就放弃 root，改用 alias + 精确 location + try_files，并注意路径末尾斜杠：

1. location ^~ /app1/ { alias /var/www/app1/; try_files $uri $uri/ /app1/index.html; }
2. location ^~ /app2/ { alias /var/www/app2/; try_files $uri $uri/ /app2/index.html; }
3. alias 路径末尾必须加 /，否则 /app1/css/style.css 会映射成 /var/www/app1css/style.css（少斜杠=拼接错误）
4. 避免混用 root 和 alias；不要在同一个 location 里既写 root 又写 alias

额外提醒：静态资源路由别依赖 location root 做“多应用托管”

比如把 React/Vue 打包产物放在 /admin/ 和 /user/ 下，看似能用 location + alias 解决，但实际会遇到：

1. 前端路由（如 /admin/dashboard）触发时，Nginx 需 fallback 到对应 index.html，而 try_files 的 fallback 路径必须与 alias 前缀一致
2. 子应用间公共资源（如 /static/）若跨目录共享，需额外 location + alias 或 proxy_pass 到统一 CDN
3. 不如直接拆成子域名 admin.example.com / user.example.com，更符合 HTTP 语义，也利于 CORS、缓存和安全策略分离