必须真实返回HTTP 404状态码,否则搜索引擎持续抓取死链、浏览器离线缓存fallback失效、PWA fetch事件监听失效;需用curl -I验证响应头含明确404,禁用302跳转或伪状态。

404页面返回200 OK而不是404状态码
这是最隐蔽也最致命的问题:页面内容看着像404,但响应头是HTTP/1.1 200 OK。搜索引擎会当它是正常页抓取,浏览器也不会触发离线缓存 fallback,PWA 的 fetch 事件监听也收不到 404 信号。
验证方式必须用命令行:curl -I https://yoursite.com/nonexistent,看第一行是否为 HTTP/1.1 404 Not Found。别信 Network 面板里“Preview”或“Response”的文字内容。
- GitHub Pages:只认仓库根目录下命名严格为
404.html的文件;/pages/404.html或404.htm全无效 - Nginx:必须写
error_page 404 /404.html;,且另加location = /404.html { internal; },否则外部直访/404.html会返回 200 - Apache:
ErrorDocument 404 /404.html要放在启用mod_alias的虚拟主机内,且确保该路径可被公开访问(不能有Deny from all) - 本地开发时:
http-server、live-server等工具默认不支持自定义 404,它们只返回index.html+ 200,不能用于测试
404页面里链接或资源仍报404
用户点进 404 页面后,发现“首页”按钮点不开、“搜索框”加载失败——这不是 404 本身没生效,而是这个页面自身又触发了新的 404。根本原因常是路径上下文错乱。
比如当前 URL 是 https://example.com/blog/post-123,而 404.html 里写的是 <a href="index.html">首页</a>,浏览器实际请求的是 /blog/index.html,但文件其实在根目录。
立即学习“前端免费学习笔记(深入)”;
- 所有导航链接必须用绝对路径:
<a href="/>%E9%A6%96%E9%A1%B5</a>%E3%80%81<a%20href=">帮助</a> - CSS/JS/image 的
href或src必须以/开头:<link rel="stylesheet" href="/css/main.css"> - 禁用
<base href="...">—— 它会全局劫持所有相对路径,极易在 404 页面中引发二次错误 - 不要在 404 页面里用 JS 动态拼接跳转:
location.href = window.location.origin + "/about"多余且危险;直接写死/about更可靠
404页面内容不显示或 JS 加载失败
很多团队花时间设计动效和搜索功能,结果用户禁用 JS、网络中断、或页面加载到一半就失败——此时连“404”两个字都看不到,只剩白屏。
404 页面的核心信息必须原生 HTML 直出,不能依赖 JS 渲染或异步请求。
-
<h1>404</h1>必须存在且为一级标题,不能是图片、SVG 文本或 CSS 伪元素生成 - 展示原始路径应使用内联脚本:
<pre class="brush:php;toolbar:false;" id="path-display"><script>document.getElementById("path-display").textContent = location.pathname</script></pre>,即使 JS 失败,<pre class="brush:php;toolbar:false;"></pre>标签本身仍占位可见 - 避免
<meta http-equiv="refresh">自动跳转——它会让响应变成 200,且对屏幕阅读器不友好 - 图标用内联 SVG,字体用系统安全字体栈(如
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;),不引外部 CDN
本地调试时始终看不到真实404行为
双击打开 HTML 文件、用 file:/// 协议访问、或跑 python -m http.server,全都不触发真实 HTTP 404 流程。这些环境根本不会返回状态码,也无法模拟服务器路由逻辑。
- 必须走真实 HTTP 服务:
vite preview(推荐)、npx serve -s、或部署到 Nginx/Apache - 确认你访问的是
http://localhost:5173/nonexistent这类地址,不是file:///Users/xxx/404.html - 用
htmlproofer扫描整个站点:htmlproofer ./_site --url-ignore "/^file:\/\//,/^http:\/\/localhost:3000/" --allow-hash-href,它会真实发起 HTTP 请求并标出哪一行的href返回了 404 - Network 面板中看到 Status 为
0?基本是跨域、file://协议限制,或目标服务主动断连,和路径拼写无关
真正难的不是写出一个好看的 404 页面,而是让服务器在每个错误路径下都稳定、精准地返回带正确状态码的响应,并确保这个页面自身不引入新错误。路径大小写、斜杠方向、构建工具的 base 配置、托管平台的规则差异——任何一个环节松动,都会让精心设计的 404 彻底失效。



















