Nginx 的 map 指令可实现基于 Cookie 的静态资源灰度加载，通过 $cookie_version 映射到不同版本路径（如 /static/v1/ 或 /static/v2/），配合 alias 动态服务资源，无需改业务代码，适用于纯前端容器化部署。
用 Nginx 的 map 指令实现基于 Cookie 的静态资源灰度加载，本质是让不同用户根据 Cookie 值加载不同版本的 JS、CSS、HTML 等前端文件。它不改业务代码、不依赖后端服务，特别适合纯前端容器化部署（如 Nginx 镜像托管静态资源）。
明确前提与目录结构
该方案生效需满足三个基础条件：
- 静态资源已按版本组织进容器镜像，例如：
/static/v1/（稳定版）、/static/v2/（灰度版） - 用户请求中携带可识别的 Cookie，如
version=canary或gray=on，且Path=/、作用域匹配请求路径 - Nginx 已启用 map 模块（默认内置，无需额外编译）
定义 Cookie 到资源路径的映射
在 http 块顶层（不能放在 server 或 location 内）添加如下配置：
map $cookie_version $resource_prefix {<br> default "/static/v1/";<br> "canary" "/static/v2/";<br> "beta" "/static/v2/";<br>}
说明：
• $cookie_version 是 Nginx 内置变量，自动提取名为 version 的 Cookie 值
• 匹配成功时设为 /static/v2/；未命中或为空时走 default 分支
• 大小写敏感，Version=canary 不会匹配
在 location 中动态挂载资源路径
在 server 块中处理静态资源请求：
location /static/ {<br> alias $resource_prefix;<br> expires 1y;<br> add_header Cache-Control "public, immutable";<br>}
效果示例：
• 请求带 Cookie: version=canary → 实际读取容器内 /static/v2/app.js
• 其他用户 → 默认读取 /static/v1/app.js
• 若需灰度 HTML 入口页，可用 try_files 配合类似映射
容器化落地关键细节
确保方案在 Docker/K8s 中稳定运行：
- 将多版本资源一并构建进镜像，例如：
COPY dist-v1/ /usr/share/nginx/html/static/v1/和COPY dist-v2/ /usr/share/nginx/html/static/v2/ - 把
map配置单独存为version-map.conf，通过 ConfigMap（K8s）或 volume（Docker）挂载，避免硬编码 - 灰度 Cookie 建议由后端登录响应头注入：
Set-Cookie: version=canary; Path=/; Max-Age=86400; Secure; HttpOnly - 首次无 Cookie 时，
$cookie_version为空，自动走default分支——这是预期行为，无需额外兜底
