必须用curl -I验证HTTP响应头,第一行状态码是唯一铁证:如curl -I https://yoursite.com/nonexistent应返回HTTP/1.1 404 Not Found,而非200或重定向;同时确认Content-Type为text/html。

必须用 HTTP 请求验证,否则你看到的只是本地文件——file:// 协议下压根没有状态码,一切检查都无效。
用 curl -I 看真实响应头
这是最准、最不可绕过的一步。浏览器界面会骗人,但 curl 返回的第一行就是铁证:
- 运行
curl -I https://yoursite.com/this-path-does-not-exist,第一行必须是HTTP/1.1 404 Not Found - 如果返回
HTTP/1.1 200 OK,说明服务器根本没触发 404 页面,而是 fallback 到了首页或默认页 - 本地测试时用
curl -I http://localhost:8000/nonexistent,前提是已启服务(如npx serve -s) - 注意:GitHub Pages、Netlify 等平台只对部署后的域名生效,
localhost或file://测试结果无意义
在 Chrome DevTools Network 面板里抓包
适合快速定位是否被中间层拦截,或路径是否被重写:
- F12 → Network → 勾选
Preserve log→ 访问一个明显不存在的路径(如/xyz-abc) - 找标红的请求项 → 点开 → 看
Response Headers中的Status是否为404 Not Found - 同时看
Request URL:它才是浏览器实际发出的地址,常暴露<base>错位、相对路径拼错、CDN 缓存旧规则等问题 - 如果该请求跳转了(
Status是301或302),点开跳转后的请求再查一次状态码
确认 404.html 文件本身被正确加载
很多人以为只要放了文件就万事大吉,其实服务器根本没读到它:
立即学习“前端免费学习笔记(深入)”;
- GitHub Pages:文件名必须是严格小写的
404.html,且位于仓库根目录(和index.html同级) - Nginx:需配置
error_page 404 /404.html;+location = /404.html { internal; },漏掉internal会导致外部直连时返回200 - Apache:
.htaccess中写ErrorDocument 404 /404.html,路径不能带点(如./404.html)或协议(如https://yoursite.com/404.html) - 本地开发工具(如 VS Code Live Server)默认不支持自定义 404,别拿它当验证依据
检查 HTML 内容是否符合硬性语义要求
即使状态码对了,内容不合格也会让页面失效或被搜索引擎误判:
-
<title></title>必须含 “404” 字样,例如<title>404 - 页面未找到</title> -
<h1></h1>必须直写文字 “404 Not Found”,不能是图片、SVG 文本或 JS 动态插入 - 核心内容必须包裹在
<main role="main"></main>中,保障屏幕阅读器可访问 - “返回首页”必须是纯
<a href="/">← 返回首页</a>,禁用onclick或<button></button> - CSS 必须内联在
<style></style>标签中,且总大小 ≤ 1KB;禁用<link rel="stylesheet">
最容易被忽略的是:状态码对了,但 Content-Type 是 text/plain 而非 text/html——某些 Nginx 配置或静态托管平台会默认设错,导致浏览器不渲染 HTML,只显示源码。务必在 Response Headers 里确认这一项。



















