root将整个URI路径拼接到指定目录后查找文件，alias则移除location匹配部分再拼接指定路径；前者适用于URI与磁盘结构一致的静态站点，后者适用于前缀映射到无关目录的场景。
在 Nginx 配置中，root 和 alias 都用于指定文件系统路径，但它们的匹配逻辑和适用场景有本质区别。用错一个，就可能导致 404、返回错误文件，甚至暴露敏感路径。
root 指令：基于 location 路径“拼接”文件系统路径
root 的作用是定义请求 URI 的“根目录”，Nginx 会将 整个请求路径（包括 location 匹配部分） 拼接到 root 指定的目录后查找文件。
例如：
location /static/ {
root /var/www;
}
当请求 /static/css/app.css 时，Nginx 实际查找的文件是：
/var/www/static/css/app.css —— 注意，/static/ 被完整保留并拼入路径。
✅ 适合场景：
- 服务静态资源站点主目录（如整个网站前端部署在
/var/www/html） - location 匹配的是 URI 前缀，且希望保持 URI 结构与磁盘结构一致
- 配合 index、try_files 等指令做常规站点托管
alias 指令：用指定路径“替换” location 匹配部分
alias 的核心是“替换”：它会把 location 中匹配到的路径部分完全移除，再将 alias 后的值作为实际起始路径来查找文件。
例如：
location /static/ {
alias /opt/assets/;
}
请求 /static/css/app.css 时，Nginx 移除匹配的 /static/，再拼上 /opt/assets/，最终查找：
/opt/assets/css/app.css —— 注意，/static/ 没有出现在最终路径里。
⚠️ 注意事项：
- alias 后的路径必须以
/结尾（除非指向单个文件），否则可能因路径拼接出错导致 403 或 404 - 不能在正则 location 中使用 alias（Nginx 1.11.5+ 支持，但需谨慎；老版本直接报错）
- 不支持与 try_files 混用（try_files 会忽略 alias，仍按 root 逻辑处理）
典型误用与排障线索
常见问题往往源于混淆两者行为：
- 用 root 写成
root /var/www/static;处理/static/xxx→ 实际找的是/var/www/static/static/xxx（多了一层 static）→ 返回 404 - 用 alias 写成
alias /var/www/static;（缺结尾 /）→ 请求/static/logo.png可能变成/var/www/staticlogo.png→ 404 或意外读取错误文件 - 在
location ~ \.php$中错误使用 alias → Nginx 报错 “alias directive cannot be used inside a regex location block”
排查建议：启用 error_log /path/to/error.log debug;，查看 access 日志中的实际文件路径，比对是否符合预期。
选型决策树：该用 root 还是 alias？
快速判断依据：
- 如果 location 是前缀匹配（如
location /api/、location /images/），且你希望 URI 路径 = 磁盘子目录结构 → 用 root - 如果 location 是前缀匹配，但你想把该 URI 前缀“映射到另一个完全无关的目录”（比如把
/static/指向 SSD 上的/mnt/fast-static/）→ 用 alias - 如果 location 是精确匹配（
location = /health）或命名 location（location @fallback），通常不用 root/alias，而是用return或proxy_pass - 需要重写 URI 或做复杂路径映射 → 考虑
rewrite+root，而非依赖 alias
