排查 root 与 alias 混用导致的“目录丢失”，本质是确认 Nginx 实际访问路径是否多层、少层或错目录；关键看 error.log 中 open() 的真实路径，对比预期路径即可定位拼接偏差。
排查 root 与 alias 混用导致的“目录丢失”，本质是确认 Nginx 实际访问的磁盘路径是否多了一层、少了一层，或者根本没进对目录。问题不在于配置语法错误，而在于拼接逻辑被误读——尤其当两者出现在同一 location 或相邻配置中时，容易让静态资源“凭空消失”。
看 error.log 里 Nginx 真正打开的路径
这是最直接、最不可跳过的一步。在 nginx.conf 中临时开启 debug 日志：
- 添加或修改：error_log logs/error.log debug;
- 执行 nginx -s reload 重载配置
- 发起一次出错请求（如访问 /static/css/main.css 返回 404）
- 立刻查看 logs/error.log，找类似这一行：
*123 open() "/var/www/html/static/css/main.css" failed (2: No such file or directory)
这个路径就是 Nginx 拼出来的结果。把它和你预期的路径（比如 /var/www/assets/css/main.css）对比：多出 /static/？少掉 /css/？路径开头就错了？这些偏差直接暴露了 root/alias 的误用位置。
检查 location 内是否同时写了 root 和 alias
Nginx 规定：同一个 location 块中若同时出现 root 和 alias，alias 会被完全忽略，只生效 root。配置不会报错，但行为已悄然改变。
- 例如：location /assets/ { root /var/www; alias /data/public/; } → 实际走的是 /var/www/assets/...，不是你想要的 /data/public/...
- 解决方法：删掉其中一个；若需前缀替换，必须只留 alias；若需根目录追加，只留 root
- 特别注意：include 进来的配置片段也可能悄悄引入另一个指令，建议全局搜索 root 和 alias
验证 alias 是否因斜杠不匹配导致路径粘连
alias 对斜杠极其敏感，“目录丢失”常表现为文件路径被错误拼接，比如 /var/www/assetsjs/app.js（assets 和 js 粘连了）。
- 规则很简单：location 末尾有 /，alias 值末尾也必须有 /
- 反例：location /static/ { alias /var/www/dist; } → 请求 /static/logo.png 会变成 /var/www/distlogo.png
- 正例：location /static/ { alias /var/www/dist/; } → 正确拼为 /var/www/dist/logo.png
- 小技巧：在 location 中加 return 200 "$request_filename";，访问时直接看到拼出的完整路径，一眼识别双斜杠或粘连
确认文件系统上是否存在且可读
路径算对了，不代表能访问。所谓“目录丢失”，有时是权限或符号链接导致的假象。
- 用 ls -ld /var/www/dist/ 检查目录是否存在、是否可进入（需 x 权限）
- 运行 stat /var/www/dist/logo.png 确认文件存在，且属主/属组允许 Nginx 进程（如 www-data 或 nginx）读取（r 权限）
- 若 alias 指向软链接，确保 Nginx 用户对软链本身、目标路径、以及所有上级目录都有 r-x 权限；必要时检查 SELinux 上下文（ls -Z）
