nginx 中 alias 不支持变量，需用 map 定义版本路径 + root/try_files 实现灰度；通过 cookie/header/ip 等触发分流，rewrite 可模拟 alias 去前缀行为。
在 Nginx 中，alias 本身不支持动态切换或条件路由，不能直接实现“灰度发布”逻辑，但它可以作为静态资源多版本目录映射的基础组件。真正的灰度能力需结合 map、if（谨慎使用）、请求头/cookie 变量及 upstream 配合完成。下面给出一种轻量、可靠、生产可用的 alias + 变量驱动多版本静态资源灰度方案。
核心思路：用变量控制 alias 目标路径
Nginx 的 alias 指令不接受变量（如 $version），但可通过 root + 重写路径的方式间接实现等效效果；更推荐的是利用 try_files + root 动态拼接，或用 map 预定义版本路径后，在 location 中引用。
关键点：
-
alias后不能跟变量，但root可与rewrite或try_files协同实现路径映射 - 灰度分流逻辑应放在
http或server块顶层，避免重复计算 - 推荐优先用
map定义版本映射关系，清晰、高效、无副作用
步骤一：用 map 定义灰度规则和版本路径
在 http 块中定义一个 map，根据 cookie、header 或 IP 等决定当前请求命中哪个版本目录：
map $cookie_version $static_root {
default "/var/www/v1";
"v2" "/var/www/v2";
"~*canary" "/var/www/canary";
"~*192\.168\.1\." "/var/www/dev"; # 按内网 IP 分流
}
说明：
-
$cookie_version读取用户请求中的version=v2这类标识 - 支持正则匹配（如
~*canary匹配任意大小写 canary） - 值为绝对路径，后续供
root指令使用
步骤二：在 location 中用 root + try_files 实现“alias 效果”
由于 alias 不支持变量，改用 root + try_files 组合，语义等价且更灵活：
location /static/ {
root $static_root;
try_files $uri $uri/ =404;
}
效果示例：
- 请求
/static/js/app.js→ 查找/var/www/v2/static/js/app.js（当$static_root = /var/www/v2） - 注意：
root会自动拼接完整 URI 路径，所以目录结构需保持一致（即各版本下都有static/子目录） - 若希望去掉 URL 中的
/static/前缀（类似alias行为），可用rewrite提前剥离：
location ^~ /static/ {
rewrite ^/static/(.*)$ /$1 break;
root $static_root;
try_files $uri $uri/ =404;
}
此时请求 /static/js/app.js 将查找 /var/www/v2/js/app.js，真正模拟了 alias /var/www/v2; 的行为。
步骤三：灰度触发方式（可选组合）
实际灰度常需多维度判断，可叠加使用：
-
Cookie 控制：前端 JS 设置
document.cookie = "version=v2; path=/;"，后端也可注入 -
Header 控制：测试时用 curl
-H "X-Release: canary"，对应 map 改为map $http_x_release $static_root { ... } -
IP 白名单：用于内部预发验证，
map $remote_addr $static_root { ~^10\.10\. /var/www/staging; } -
随机比例：用
map+$request_id或$msec做哈希分流（适合简单 A/B）
不复杂但容易忽略：所有路径变量必须是绝对路径；map 必须定义在 http 块；root 后不要加 trailing slash（Nginx 会自动处理）；静态文件目录权限需对 nginx worker 用户可读。
