alias指令核心是前缀替换而非路径拼接，需location以/结尾精确匹配，如location /api/v1/docs/ { alias /opt/swagger-ui/; }；与root本质不同，前者替换前缀，后者追加完整uri。

在 Nginx 中，alias 指令用于将 location 匹配到的 URL 路径**替换为指定的文件系统路径**，实现 URL 路径与物理路径之间的非对称映射——即 URL 路径前缀不等于实际目录结构。这和 root 的“拼接”逻辑有本质区别。

理解 alias 的核心行为：完全替换匹配部分

alias 会把 location 块中匹配到的**整个前缀路径**（包括斜杠）从请求 URI 中移除，并用 alias 后面指定的路径**完全替代**。关键点是：它不拼接，而是替换。

例如：

• 请求 /static/js/app.js
• 配置：location /static/ { alias /var/www/assets/; }
• Nginx 实际查找的文件是：/var/www/assets/js/app.js

注意：/static/ 被完整去掉，然后替换成 /var/www/assets/，再拼上剩余路径 js/app.js。所以 alias 值末尾的斜杠必须与 location 的斜杠语义一致（通常建议都带斜杠）。

常见错误与正确写法对比

容易出错的地方集中在斜杠位置和路径完整性上：

• 错误：location /images/ { alias /data/pics; } → 缺少末尾斜杠，会导致请求 /images/logo.png 映射成 /data/picslogo.png（路径粘连）
• 正确：location /images/ { alias /data/pics/; } → 请求 /images/logo.png 映射为 /data/pics/logo.png
• 错误：location /api/ { alias /opt/backend/; } + 后端是 FastCGI → 若未配合 fastcgi_param SCRIPT_FILENAME 重设，PHP 脚本路径会错乱
• 正确：搭配 fastcgi_param SCRIPT_FILENAME $request_filename; 或显式构造（因 $request_filename 在 alias 下已解析为真实路径）

结合正则 location 实现灵活映射

利用正则表达式捕获组，可实现动态路径重写，突破静态前缀限制：

• 需求：把 /v1/users/* 映射到 /opt/api-v2/users/*
• 配置：location ~ ^/v1/(.+)$ { alias /opt/api-v2/$1; }
• 效果：/v1/users/list → /opt/api-v2/users/list

注意：正则 location 中使用 alias 时，$1 等变量代表捕获内容，且 alias 值末尾不强制加斜杠（但需确保拼接逻辑正确），推荐显式写出完整目标路径。

alias 与 root 的关键区别速查

两者根本差异在于路径处理方式：

• root：保留原始 URI 路径，在 root 值后直接拼接。如 root /var/www; location /img/ { ... } → /img/logo.png 查找 /var/www/img/logo.png
• alias：丢弃 location 定义的匹配前缀，用 alias 值替换。如 location /img/ { alias /data/images/; } → /img/logo.png 查找 /data/images/logo.png
• 结论：需要“URL 路径前缀 ≠ 物理目录名”时，必须用 alias；需要“保持路径层级一致”时，优先用 root