静态资源多版本部署时 Nginx Root 如何配

Nginx 多版本静态资源部署应优先用 location + alias 实现精准路径映射，避免 root 硬编码导致的路径错位；alias 末尾须带斜杠且完全替换匹配 URI，而 root 是拼接路径；也可用 map 模块动态解析版本号配合 root，或结合前端 base href 统一路由。

静态资源多版本部署时，Nginx 的 root 配置核心在于让不同版本路径能被精准映射，同时避免硬编码、路径冲突或 404。关键不是写死一个 root，而是结合 location + alias 或 root + 变量/重写，实现灵活路由。

用 location + alias 区分版本目录

推荐方式：每个版本放在独立子目录（如 /static/v1.2.0/），通过 location 按前缀匹配，用 alias 指向具体物理路径，避免 root 拼接导致的路径错位。

示例：

location /static/v1.2.0/ {alias /var/www/static/v1.2.0/;}location /static/v2.0.1/ {alias /var/www/static/v2.0.1/;}

注意：alias 末尾必须带斜杠，且它会完全替换匹配的 URI 路径段；而 root 是拼接路径，容易出错（比如 root /var/www; location /static/ { ... } 会找 /var/www/static/，不适用于多版本并存）。

用变量动态解析版本号（适合灰度或自动发布）

若版本号来自请求路径（如 /app/v2.1.0/js/app.js），可提取版本段，再用 root 动态拼接：

1. 启用 ngx_http_map_module（默认内置），定义版本到路径的映射
2. 或用 rewrite 提取版本号，配合 root 指令

示例（map 方式更安全）：

map $uri $version_root {~^/app/v(?<v>[^/]+)/(.*)$ /var/www/app/$v;default/var/www/app/latest;}server {location /app/ {root $version_root;try_files $uri =404;}}

配合 index.html 的 base href 使用

前端打包时若设置了 <base href="/app/v2.0.1/">，则所有相对路径（js/app.js）会自动加上该前缀。此时 Nginx 不需要为每个资源单独配 location，只需确保 /app/v2.0.1/ 整体指向正确目录：

1. 用 root /var/www; + location /app/v2.0.1/ { } 即可
2. 但要注意：root 指向的是上级目录，Nginx 会把 /app/v2.0.1/js/app.js 解析为 /var/www/app/v2.0.1/js/app.js
3. 确保磁盘路径结构与 URI 路径严格一致

避免常见坑

1. 别混用 root 和 alias 在同一 location：二者机制冲突，Nginx 会报错或行为异常
2. root 后不要加 URI 路径段：如 root /var/www/static/v1.2.0; 是错的，应写 root /var/www;，再靠 location 匹配
3. 注意 trailing slash：alias 值末尾必须有 /；root 值末尾不能有 /（Nginx 自动处理）
4. 版本目录权限和 SELinux 上下文：确保 Nginx worker 进程能读取对应目录，尤其新版本目录刚解压后

本质是把“版本”当作 URI 的一部分来路由，而不是靠 root 硬编码版本路径。选 alias 明确、选 map 灵活、选 root 简单但需路径对齐——按发布流程和运维习惯选一种即可。