404页面生效需满足三要素:文件严格命名为404.html并置于根目录;服务器返回真实HTTP 404状态码;HTML结构语义化,含404 Not Found及有效导航。

不麻烦,但容易踩坑——核心就三件事:文件放对位置、服务器返回真实 404 状态码、HTML 结构合规。其余都是锦上添花。
404.html 文件必须严格命名并放根目录
所有主流静态托管平台(GitHub Pages、Vercel、Netlify、Cloudflare Pages)只认一个名字:404.html,小写、无空格、无 BOM、无 front matter 渲染干扰。
- 写成
404.htm、error-404.html、pages/404.html或404.HTML都无效 - Git 提交前用
git ls-files | grep 404确认文件真被跟踪;Windows 记事本保存可能加 BOM,建议用 VS Code 或 Sublime 以 UTF-8 无 BOM 保存 - Jekyll 用户必须在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被当作普通页面渲染
服务器必须返回真实 HTTP 404 状态码,不能跳转
光有文件没用。浏览器控制台若显示 Failed to load resource: the server responded with a status of 200 OK,说明服务器悄悄返回了 200,你的 404.html 只是被当普通 HTML 加载了。
- Apache:在
.htaccess中写ErrorDocument 404 /404.html(路径必须以/开头) - Nginx:在
server块中加error_page 404 /404.html;,并确保location = /404.html存在且未被rewrite覆盖 - SPA 应用(React/Vue)常见陷阱:
location / { try_files $uri $uri/ /index.html; }会吞掉所有 404,必须排除/404.html:改成try_files $uri $uri/ /index.html =404;或显式放行
404
必须可见、语义化、不可绕过
搜索引擎和屏幕阅读器靠结构识别错误页。用图片、SVG 文本、JS 插入“404”或藏在 CSS 里,都会让页面变成“软 404”——Google 可能把它当普通页面索引,视障用户听不到关键信息。
立即学习“前端免费学习笔记(深入)”;
-
<h1>404 Not Found</h1>是硬性要求,必须纯文本、不可隐藏、不可 JS 动态生成 - 标题
<title></title>也必须含 “404” 或 “Not Found”,例如<title>404 - 页面未找到</title> - 导航按钮必须用真实
<a href="/"></a>,禁用<meta http-equiv="refresh">和无交互的window.location.href = '/'—— 否则状态码变 200,破坏 SEO - 推荐结构:
<main><h1>404</h1> <p>找不到你要的页面</p> <a href="/">返回首页</a></main>
最常被忽略的点是:本地双击打开 404.html 永远测不出效果——必须走 HTTP 服务(npx serve、python3 -m http.server 或部署后测试),且要检查 Network 面板里响应头的 Status 确实是 404 Not Found。



















