nginx-404

Nginx 404 Not Found 的定位与修复

现象

请求返回 404 Not Found。可能是文件确实不存在，也可能是 root/alias、location 或 try_files 配置导致路径解析错误。

快速定位

tail -f /var/log/nginx/error.log
nginx -T | grep -nE 'root|alias|try_files|location|rewrite'
ls -l /var/www/html/path
curl -v http://127.0.0.1/path

常见根因

1. root 或 alias 指向了错误目录；alias 的尾斜杠语义尤其容易错。
2. try_files 配置不匹配，回退到了不存在的文件。
3. location 优先级和正则顺序导致请求进了错误的块。
4. 前端路由（SPA）没有回退到 index.html。
5. 文件大小写、尾斜杠或 URL 重写不一致。
6. 反向代理的 proxy_pass 路径拼接错误，后端返回 404。

修复

• 用 nginx -T 看最终生效配置，确认请求命中哪个 location。
• 静态文件确认 root/alias 拼出的真实路径，alias 结尾斜杠要匹配。
• SPA 用 try_files $uri $uri/ /index.html;。
• 检查 rewrite 和 proxy_pass 的路径拼接，必要时用 proxy_pass http://backend/; 对比。
• 大小写敏感文件系统要统一 URL 和文件名。
• 确认 404 来自 Nginx 还是后端；看响应头和上游日志。

相关命令

• nginx — 配置与日志
• curl — 复现请求
• ls — 确认文件存在