必须用真实HTTP请求验证404状态码,文件须严格命名为404.html并置于根目录,HTML需含语义化标签、内联CSS/JS、noindex元标签,且服务器须返回404状态码、text/html类型及正确响应体。

确认服务器是否真返回 404 状态码
光有 404.html 文件,90% 的情况会返回 200 OK——搜索引擎当它是正常页,浏览器也无从触发重试逻辑。必须用真实 HTTP 请求验证。
- 本地测试别双击打开:
file:///协议没有状态码概念;改用npx serve -s或python3 -m http.server 8000 - 访问一个肯定不存在的路径(如
/xyz123),打开 DevTools → Network → 查看该请求的 Status 是否为404 Not Found - 命令行最准:
curl -I http://localhost:8000/xyz123,第一行必须是HTTP/1.1 404 Not Found - 常见陷阱:SPA 的
try_files $uri $uri/ /index.html规则会把所有 404 吞掉,返回200的index.html;需排除/404.html路径
静态托管平台的命名与路径硬约束
GitHub Pages、Vercel、Netlify、Cloudflare Pages 这些平台只认一个确切路径和文件名,错一个字符就失效。
- 文件必须严格命名为
404.html(全小写,无空格,无隐藏后缀);404.htm、error404.html、pages/404.html、404.HTML全部无效 - 必须放在项目/仓库根目录下;
/docs/404.html不会被识别(GitHub Pages 尤其典型) - Jekyll 用户需在
404.html开头加 front matter:---\npermalink: /404.html\npublished: false\n---,否则会被渲染为普通页面 - Git 提交前检查:
git ls-files | grep 404,避免 Windows 记事本悄悄加 BOM
HTML 结构里哪些标签和内容不能省
404.html 不是普通网页,而是服务端注入的错误响应体,语义和可访问性必须硬保障。
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
-
<title></title>必须含 “404”,如<title>404 - 页面未找到</title>;否则搜索结果点进来像进了首页 -
<h1></h1>必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是图片、SVG 文本或 JS 渲染内容 - 主内容用
<main></main>包裹,或加role="main",让屏幕阅读器跳过导航直接读错误信息 - 加
<meta name="robots" content="noindex">,防止被搜索引擎误收录 - 显示用户原本想访问的路径:
<script>document.write(location.pathname)</script>,帮助确认是否拼写错误
CSS 和跳转逻辑必须内联且不依赖 JS
外部资源极大概率加载失败,JS 跳转在禁用脚本、网络中断、或 Service Worker 拦截时完全失效。
立即学习“前端免费学习笔记(深入)”;
- CSS 必须写在
<style></style>标签里,控制在 1KB 以内;禁用<link rel="stylesheet"> - 所有图片用绝对根路径(如
/img/404-icon.svg)或 data URL;相对路径在/blog/post/xxx下会错成/blog/post/img/... - “返回首页”必须用
<a href="/">← 返回首页</a>,不是<button onclick="location.href='/'"></button> - 想显示“回到上一页”?先判断
document.referrer是否同域且非空,否则按钮href="#"并置灰 - 禁用
<meta http-equiv="refresh">和setTimeout(() => location.href = '/', 2000);它们会返回200状态,Google 视为软 404
真正的难点不在写 HTML,而在于确保服务器在资源不存在时,同时满足三件事:返回 404 Not Found 状态码、响应头 Content-Type: text/html、响应体是你写的 404.html 内容——少一个,SEO 和用户体验就掉一档。


















