排查Nginx虚拟主机目录映射错误，关键是通过error_log查看真实打开路径，结合$request_filename验证拼接结果，用测试文件反向确认映射有效性，并严格核对location与alias斜杠一致性。
排查 Nginx 虚拟主机中目录映射错误，关键不是看 access_log，而是盯住 error_log——它会直接告诉你 Nginx 实际尝试打开哪个路径、为什么失败。
查 error_log 看真实打开路径
Nginx 在访问静态文件失败时（如 403、404），error_log 里会明确写出它拼出来的绝对路径和失败原因。这是最可信的一手证据。
- 确保 error_log 开启 debug 级别（临时）：error_log /var/log/nginx/error.log debug;（加在 http 或 server 块中）
- 发一次请求，例如：curl -I http://example.com/static/logo.png
- 立刻查看日志，找类似这样的行：
*1234 open() "/var/www/assets/logo.png" failed (2: No such file or directory)
→ 这说明 alias/root 拼出的路径是 /var/www/assets/logo.png，但该路径不存在 - 若看到 (13: Permission denied)，说明路径存在但权限不足，问题转向用户与目录权限匹配
用 $request_filename 辅助验证拼接逻辑
$request_filename 是 Nginx 内部已计算完成的最终磁盘路径，比人工推算更可靠，适合写进 access_log 对照观察。
- 定义调试日志格式：log_format debug '$remote_addr "$request" → $request_filename';
- 在对应 location 块中启用：access_log /var/log/nginx/vhost_debug.log debug;
- 请求后查看日志，例如：
127.0.0.1 "GET /static/js/app.js HTTP/1.1" → /project/dist/js/app.js
→ 可确认 alias 是否把 /static/ 正确映射到了 /project/dist/
放测试文件反向验证映射是否生效
不改配置、不重启，靠“存在性”快速判断：目标路径到底有没有被正确指向。
- 在你期望 alias 或 root 指向的目录下，手动创建一个极简文件，比如：touch /project/dist/test.ok
- 访问对应 URL：curl -I http://example.com/static/test.ok
- 返回 200 → 映射路径正确；
返回 404 → Nginx 拼出的路径与你预期不符；
返回 403 → 路径对但权限缺失（目录缺 x、文件缺 r，或用户不匹配）
核对 location 和 alias/root 的斜杠一致性
斜杠不一致是静默出错的高频原因，Nginx 不报错，但路径拼接结果完全偏离预期。
- 若 location 是 location /static/ {，alias 后必须带结尾斜杠：alias /var/www/assets/;
- 若 location 是 location /static {（无尾斜杠），alias 后就不能加斜杠：alias /var/www/assets;
- root 指令不受此限制，但需注意它和 URI 的拼接逻辑（root 是追加完整 URI，alias 是替换匹配部分）
