root将完整URI路径拼接到指定目录后，要求文件系统结构与URL路径严格镜像；alias则删除匹配前缀后再拼接，实现URL前缀到目录根的映射。
root 和 alias 看似都是“指定文件在哪”，但它们在 Nginx 处理请求 URI 时的路径计算逻辑截然不同——这不是配置风格差异，而是寻址模型的根本分叉。用错一个，404 就很难避免。
root：URI 全量拼接，路径结构必须镜像对齐
root 指令把 location 块匹配到的**完整请求路径（含前缀）**，原封不动追加到指定目录后，形成最终文件路径。
- 例如：location /static/ { root /data/www; }，访问 /static/css/main.css → 查找 /data/www/static/css/main.css
- 关键点：/static/ 这段前缀被完整保留并拼入。所以 /data/www 下必须真实存在 static/ 子目录
- 若 location 写成 location /static（不带尾斜杠），则 /static 会被当作普通路径段拼入，可能误导向 /data/www/static（而非 /data/www/static/）
- root 可出现在 http、server、location 任意层级，适用范围更广
alias：URI 前缀被精准替换，路径起点彻底重定向
alias 指令会将 location 中**匹配成功的前缀部分（含斜杠）完全删除**，再把剩余 URI 路径拼接到 alias 指定的目录后。
- 例如：location /static/ { alias /data/assets/; }，访问 /static/css/main.css → 查找 /data/assets/css/main.css
- 核心规则：alias 值末尾必须带斜杠（如 /data/assets/），否则 Nginx 会错误拼接为 /data/assetss/css/main.css
- location 的匹配字符串（如 /static/）必须与 alias 替换逻辑严格对应；若写成 location ~ ^/static/（正则），alias 会直接报错，除非配合 capture 和 $1 显式重写
- alias 只允许出现在 location 块内，不能用于 server 或 http 级别
典型误用场景与调试线索
很多 404 实际源于路径计算预期偏差，而非文件缺失。
- 用 root 配置子路径却忘了目录结构要同步 —— 比如想让 /api/ 指向 /opt/app/，却写成 location /api/ { root /opt/app; }，结果去找 /opt/app/api/xxx，而非 /opt/app/xxx
- alias 值漏掉末尾斜杠 —— alias /var/www/static 导致 /static/img.png 被解析为 /var/www/staticimg.png
- location 匹配不带斜杠（如 location /assets）时 alias 行为不可靠，Nginx 可能忽略或重复处理路径段
- 开启 error_log /var/log/nginx/error.log notice;，日志中会出现类似 "open() "/data/assets/js/app.js" failed (2: No such file)" 的实际查找路径，是定位问题最直接依据
一句话选型逻辑
想把整个 URL 树“平移挂载”到某目录下（URL 路径 = 文件系统路径）→ 用 root；
想把某个 URL 前缀“映射到另一个目录根”（URL 前缀仅作路由标识，不参与路径构造）→ 用 alias。
