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 动态拼接：
- 启用
ngx_http_map_module（默认内置），定义版本到路径的映射 - 或用
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;
}
}</v>
配合 index.html 的 base href 使用
前端打包时若设置了 <base href="/app/v2.0.1/">，则所有相对路径（js/app.js）会自动加上该前缀。此时 Nginx 不需要为每个资源单独配 location，只需确保 /app/v2.0.1/ 整体指向正确目录：
- 用
root /var/www;+location /app/v2.0.1/ { }即可 - 但要注意：root 指向的是上级目录，Nginx 会把
/app/v2.0.1/js/app.js解析为/var/www/app/v2.0.1/js/app.js - 确保磁盘路径结构与 URI 路径严格一致
避免常见坑
- 别混用 root 和 alias 在同一 location：二者机制冲突，Nginx 会报错或行为异常
-
root 后不要加 URI 路径段：如
root /var/www/static/v1.2.0;是错的，应写root /var/www;，再靠 location 匹配 - 注意 trailing slash：alias 值末尾必须有 /；root 值末尾不能有 /（Nginx 自动处理）
- 版本目录权限和 SELinux 上下文：确保 Nginx worker 进程能读取对应目录，尤其新版本目录刚解压后
本质是把“版本”当作 URI 的一部分来路由，而不是靠 root 硬编码版本路径。选 alias 明确、选 map 灵活、选 root 简单但需路径对齐——按发布流程和运维习惯选一种即可。
