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
