Web 服务器与网关 / 系统课时

Nginx 返回 404 应该查什么

Nginx 返回 404 应该查什么

同一个文件存在于磁盘,并不意味着当前请求会映射到它。本篇从入口站点、location 和路径拼接逐层排查静态 404,用 root 与 alias 的实际对照确认目标文件,再分辨错误来自 Nginx 还是上游应用。

学习目标

  • 按实际请求定位 server、location 与目标文件路径。
  • 对照 root 和 alias 查找部署或路径配置错误。
  • 用已知正常文件和缺失文件验证修复范围。

先还原请求经过的选择过程

记录请求协议、域名、端口、路径和响应状态。域名解析错误、Host 不匹配或端口不同,都可能让请求进入另一个 server;此时修改预期站点的 root 不会影响实际结果。

站点、路径规则和文件映射逐层决定静态请求结果

用 nginx -T 查看运行安装对应的完整配置及 include,而不是只看编辑器里的某一份文件。配置检查或重载失败时,运行实例仍可能使用旧配置;配置输出可能包含敏感信息,应在受控环境查看。

准备一个确定存在的测试文件

实验需要 Linux、curl、Nginx 1.28 及空闲回环 8080。下面目录只用于本次实验,已有同名数据时换一个新目录,并同步修改配置:

bash
mkdir -p /tmp/nginx-404-lab/site/assets
printf 'asset-ok\n' > /tmp/nginx-404-lab/site/assets/app.txt

预期结果:文件位于 site/assets/app.txt。Master 与 Worker 需具有相应目录与文件访问权限。以下片段示例放入 http;已有同监听 default_server 时先合并:

nginx
server {
    listen 127.0.0.1:8080 default_server;
    server_name _;
    return 404;
}
server {
    listen 127.0.0.1:8080;
    server_name files.test;
    root /tmp/nginx-404-lab/site;
    error_log /tmp/nginx-404-lab/error.log error;
    location /assets/ { }
    location /media/ { alias /tmp/nginx-404-lab/site/assets/; }
    location / { return 404; }
}

/assets/app.txt 经 root 追加完整 URI,得到 site/assets/app.txt;/media/app.txt 用 alias 替换 /media/ 前缀,也得到同一个文件。alias 的目录尾斜杠与 location 边界需要对齐。

对照两个入口及一个缺失路径

检查并重载后执行:

bash
curl --noproxy '*' --resolve files.test:8080:127.0.0.1 -sS -w 'status=%{http_code}\n' http://files.test:8080/assets/app.txt
curl --noproxy '*' --resolve files.test:8080:127.0.0.1 -sS -w 'status=%{http_code}\n' http://files.test:8080/media/app.txt
curl --noproxy '*' --resolve files.test:8080:127.0.0.1 -sS -o /dev/null -w 'status=%{http_code}\n' http://files.test:8080/assets/missing.txt

预期输出:

text
asset-ok
status=200
asset-ok
status=200
status=404

再把 Host 改成 unknown.test,应进入默认站点返回 404,即使 app.txt 仍存在。缺失资源请求的 error.log 通常包含尝试打开的实际路径,可用它确认到底拼接到了哪里。

按证据修复,保留真实缺失响应

发现 检查方向
日志路径多一层 assets root 是否已经包含了 URI 中的目录
alias 目标少分隔符 两端尾斜杠与匹配前缀是否正确
文件名只在开发机成功 大小写、构建产物和部署目录是否一致
所选 location 带 proxy_pass 404 可能来自应用路由,继续查上游日志

权限不足通常应另按 403 及错误原文排查,不能因为所有错误都显示自定义页面就混为一谈。不要把所有静态文件 404 回退为 SPA HTML,否则缺失 JS 可能得到 200 文本并掩盖部署问题。

站点选择与 root 映射过程见 Nginx 请求处理说明。修复后重复正常文件、缺失文件、未知 Host 和实际业务路径;目标是正确资源成功、真实缺失仍明确失败。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Nginx 返回 404 应该查什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通