root将整个URI拼接到指定根目录后，alias则用指定路径替换location匹配前缀；root适用于URI即文件路径的场景，alias适用于URL前缀映射到独立目录的场景。
Nginx 中的 root 和 alias 都用于将请求路径映射到文件系统，但行为完全不同——用错会导致 404、返回错误文件，甚至安全风险。
root：在 location 路径末尾拼接 URI
root 指令指定的是“根目录”，Nginx 会把 整个请求 URI（包括 location 匹配部分）追加到 root 路径后，再查找文件。
例如：
location /static/ {root /var/www;
}
当访问 /static/css/app.css 时，Nginx 实际查找的路径是：/var/www/static/css/app.css（注意：/static/ 被完整拼进去了）
常见误用场景：
- location 写成
/static（无结尾斜杠），而请求是/static/xxx→ 可能匹配失败或路径错位 - 想让
/api/指向/opt/backend/，却写root /opt/backend;→ 实际找的是/opt/backend/api/xxx，而非预期的/opt/backend/xxx
alias：用指定路径完全替换 location 匹配部分
alias 是“别名替换”：Nginx 会删除 location 中已匹配的前缀，再把剩余 URI 拼到 alias 路径后。
同样例子：
location /static/ {alias /var/www/assets/;
}
访问 /static/css/app.css 时，Nginx 去掉匹配的 /static/，剩下 css/app.css，再拼到 /var/www/assets/ 后 → 实际路径为：/var/www/assets/css/app.css
关键细节：
-
alias值必须以/结尾（除非指向单个文件），否则可能因路径拼接出错 -
location的末尾斜杠必须与alias的末尾斜杠语义对齐：两者都带或都不带易引发歧义，推荐统一带斜杠 - 不能在正则 location 中使用
alias（Nginx 1.11.5+ 支持命名捕获 + alias，但需谨慎）
怎么选？看 URI 是否要参与路径构造
判断逻辑很简单：
- 如果请求路径本身就应该作为文件系统路径的一部分（比如静态资源按 URL 层级存放），用
root - 如果只是把某个 URL 前缀“映射到”另一个目录（不保留该前缀在磁盘结构中），用
alias
典型适用场景：
-
root：整个站点托管（location / { root /var/www/html; }） -
alias：挂载子模块（如把/blog/映射到独立博客程序目录）、CDN 回源路径重写、前端路由 fallback 到 index.html
调试技巧：用日志确认真实路径
在 server 或 location 块中临时加入：
log_format debug '$request_uri → $document_root$uri';access_log /var/log/nginx/debug.log debug;
然后访问目标 URL，查看日志中 Nginx 实际拼出的路径，比凭空推理更可靠。
另外，开启 nginx -t 只检查语法，不会验证路径是否存在；真正测试需配合 curl -I 或浏览器开发者工具看响应状态码和 Content-Location。
