排查 root 与 alias 路径问题，关键看 error.log 中 nginx 实际访问路径：若含 location 前缀（如 /var/www/static/xxx），说明用了 root；若不含前缀（如 /var/data/xxx），说明用了 alias。注意 alias 值末尾必须加 /，且 location 应以 / 结尾，禁止在 location / 中使用 alias。
排查 root 与 alias 的路径拼接问题，关键不是背概念，而是看 nginx 实际去哪个路径找文件——这个路径就藏在 error.log 里。只要打开错误日志，对照请求 URI 和配置，一眼就能判断是拼错了还是替错了。
看 error.log 里 nginx 真正访问的路径
遇到 404，第一件事就是查 error.log。日志里那句 open() "/xxx/yyy" failed 就是真相：
- 如果日志路径里多出了 location 前缀（比如配置了
location /static/，日志却显示/var/www/static/xxx），那就是用了 root，它把完整 URI 拼进去了； - 如果日志路径里没有 location 前缀（同样
location /static/，日志却是/var/data/xxx），说明用了 alias，前缀被替换了。
动手验证：用最简配置复现逻辑
别猜，直接写两行最小配置跑一下：
-
root 测试：
location /test/ { root /tmp; }
访问/test/a.txt→ nginx 查/tmp/test/a.txt -
alias 测试：
location /test/ { alias /tmp/data/; }
访问/test/a.txt→ nginx 查/tmp/data/a.txt（注意 alias 路径末尾必须有/）
检查 alias 是否漏掉斜杠或位置错配
alias 出 404，八成是这两个细节翻车：
-
alias 值末尾没加 /：比如写成
alias /tmp/data，请求/test/file.js就会变成/tmp/datafile.js（连在一起了）； -
location 写法和 alias 不匹配：若
location /api（不带尾部 /），对应alias /opt/app/就可能出错；更稳妥的是统一写成location /api/+alias /opt/app/； - 不能在 location / 里用 alias：这种全局匹配会导致替换逻辑混乱，一律改用 root。
对照表格快速定位行为差异
记不住？贴一张现场核查表：
| 配置项 | 请求 URI | 实际查找路径 | 典型错误表现 |
|---|---|---|---|
location /img/ { root /var/www; } |
/img/logo.png |
/var/www/img/logo.png |
文件其实在 /var/www/logo.png，但 nginx 去找 /img/ 子目录 |
location /img/ { alias /var/www/; } |
/img/logo.png |
/var/www/logo.png |
alias 路径没加 / → 变成 /var/wwwlogo.png
|
