alias用于完全替换location匹配前缀，将剩余uri拼接到指定路径后；root则是将完整uri（含location部分）追加到根路径后，二者语义不同，混用或斜杠不匹配易致404。
Nginx 中 alias 指令用于将 location 匹配的 URI 路径映射到文件系统中的另一个目录，实现静态资源的“目录重定向”。它和 root 的行为有本质区别：alias 会**完全替换** location 路径部分，而 root 是拼接。用错容易导致 404。
alias 的核心规则：路径替换而非拼接
当 Nginx 匹配到某个 location 时，alias 会把该 location 的完整匹配前缀（包括斜杠）从请求 URI 中移除，再把剩余部分拼接到 alias 指定的路径后。关键点：
- location 中的路径必须以 / 结尾（除非是精确匹配
=），否则可能因末尾斜杠处理不一致引发问题 - alias 值末尾也建议加 /，避免路径拼接出错（如
alias /var/www/static/;） - URI 和 alias 的路径结构要对齐 —— 例如
location /assets/对应alias /data/web/assets/;，访问/assets/js/app.js就会找/data/web/assets/js/app.js
典型配置示例
假设想把 /static/ 下的所有请求指向服务器上 /opt/myapp/public/ 目录：
location /static/ {
alias /opt/myapp/public/;
}
此时：
-
GET /static/css/style.css→ 实际读取/opt/myapp/public/css/style.css -
GET /static/→ 会尝试读取/opt/myapp/public/index.html（若开启 index 指令） - 注意：
location /static（无尾部斜杠）和location /static/行为不同，前者会把/staticabc也匹配进来，通常应避免
常见坑与避坑方法
alias 容易出错的地方集中在路径拼接逻辑上：
- 不要混用 root 和 alias 在同一 location 中 —— 二者互斥，同时存在会导致配置加载失败
-
正则 location 中用 alias 要格外小心 —— 若 location 使用
~或~*，alias 值不能包含捕获变量（如$1），除非你明确知道如何引用；更稳妥的做法是改用root+ rewrite 或直接用try_files -
alias 不支持自动追加 index 文件 —— 如果访问的是目录（如
/static/），需显式配置index index.html;，且确保 alias 指向的目录下存在对应文件 - 测试时可用
curl -I http://localhost/static/test.txt看返回状态码，配合error_log /var/log/nginx/error.log debug;查看实际查找路径
对比 root：什么情况下该用 alias？
用 alias 的典型场景是：URI 路径和文件系统路径结构不一致，需要“剪掉”一段再映射。
- 想把
/api-docs/映射到/usr/share/nginx/html/redoc/→ 用 alias（URI 前缀被替换） - 想把所有
/images/*请求都指向/var/www/images/→ 用 alias 更直观 - 但若只是给整个站点设基础路径，比如
location / { root /var/www/html; }→ 应用 root，因为它是拼接模式，更自然
