在 linux 中配置 nginx 实现多版本前端资源切换，核心做法是利用 alias 指令配合 url 路径参数或 cookie 进行动态映射。具体而言，通过正则表达式捕获请求中的版本号（如 /v1/... 或 ?ver=v2），将匹配到的 uri 重定向到对应的物理目录（如 /var/www/app/v1）。这样做可以直接根据客户端请求的特征返回不同版本的静态文件，无需修改 nginx 配置文件即可实现灰度发布或 a/b 测试。若未指定版本，默认指向最新稳定版目录。
如何通过 URL 路径参数区分版本并配置 alias？
通过 URL 路径前缀区分版本是最直观的做法。在 location 块中使用正则表达式匹配版本号，并使用 alias 将匹配的 URI 部分替换为具体的物理路径。例如，匹配 /app/v1/ 开头的请求，将其映射到 /var/www/frontend/v1/ 目录。这种配置要求路径结构严格对应，且 alias 后的路径必须包含末尾斜杠以正确拼接剩余 URI。
server {
listen 80;
server_name example.com;
# 默认版本：v2
location /app/ {
alias /var/www/frontend/v2/;
index index.html;
}
# 显式指定 v1 版本
location ~ ^/app/v1/(.*)$ {
alias /var/www/frontend/v1/$1;
try_files $uri $uri/ /index.html;
}
# 显式指定 v3 版本
location ~ ^/app/v3/(.*)$ {
alias /var/www/frontend/v3/$1;
try_files $uri $uri/ /index.html;
}
}
上述配置中，当用户访问 http://example.com/app/v1/index.html 时，Nginx 会提取 v1/ 后的 index.html，并通过 alias 映射到 /var/www/frontend/v1/index.html。注意 alias 与 root 的区别：root 是将 location 路径追加到根路径后，而 alias 是完全替换 location 匹配的路径部分。因此在使用正则 location 时，alias 必须明确写出替换后的完整路径结构，包括捕获组变量 $1。
如何利用 Cookie 实现无感知的版本切换？
对于不希望改变 URL 结构的场景，可以通过检查请求头中的 Cookie 来决定使用哪个 alias。利用 map 指令根据 $http_cookie 的值设置一个内部变量 $frontend_version，然后在 location 中使用该变量构建 alias 路径。这种方法对前端透明，用户只需刷新页面即可切换版本，适合 A/B 测试或灰度发布。
map $http_cookie $frontend_version {
default "v2";
"~*version=v1" "v1";
"~*version=v3" "v3";
}
server {
listen 80;
server_name example.com;
location /app/ {
alias /var/www/frontend/$frontend_version/;
index index.html;
try_files $uri $uri/ /index.html;
}
}
在此配置中，如果请求携带 Cookie: version=v1，则 $frontend_version 被设为 v1，alias 指向 /var/www/frontend/v1/。否则默认为 v2。需要注意的是，map 指令必须放在 http 块内，且在 server 块之外。此外，alias 中使用变量时，Nginx 会在运行时解析该路径，确保灵活性。若需支持更多版本，只需在 map 中添加新的规则即可，无需修改 location 逻辑。
当 alias 指向的目录不存在时 Nginx 会返回什么错误？
当 alias 指令指向的物理目录不存在时，Nginx 不会自动创建目录，而是直接返回 404 Not Found 错误。这是因为 alias 的作用是路径映射，而非文件生成。如果配置的版本目录（如 /var/www/frontend/v1/）尚未部署或路径拼写错误，Nginx 无法找到对应的静态文件，便会向客户端返回标准的 404 响应。开发者在排查此类问题时，应首先检查目录是否存在、权限是否正确，以及 alias 路径是否与 try_files 中的 fallback 逻辑冲突。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
