404页面必须由服务器真实返回404 Not Found状态码,否则无效;本地双击打开file://协议下无HTTP状态码,永远返回200 OK;需用npx serve等HTTP服务验证,且静态托管平台仅认根目录下小写的404.html。

404页面不是“写个HTML放上去就行”,它必须被服务器真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户刷新无重试提示、无障碍设备读不出错误意图。
为什么本地双击打开 404.html 永远不生效
file:// 协议下没有 HTTP 状态码概念,浏览器只会返回 200 OK。你看到的“404”只是文字,不是错误响应。
- 验证必须走真实 HTTP 服务:用
npx serve -s启服务,访问http://localhost:5000/xxx-abc - 打开 DevTools → Network → 找该请求 → 看 Response Headers 里
Status是否为404 Not Found - 更准的方式是命令行:
curl -I https://yoursite.com/nonexistent,第一行必须是HTTP/1.1 404 Not Found - GitHub Pages、Vercel、Netlify 等平台只在部署后才接管 404;本地预览时它们不参与
404.html 文件名和位置的硬性要求
静态托管平台(GitHub Pages、Vercel、Netlify、Cloudflare Pages)只认一个路径+文件名组合:根目录下的 404.html(全小写、无空格、无 BOM)。
- 写成
404.htm、error404.html、pages/404.html或404.HTML都会失效 - Git 提交前检查:
git ls-files | grep 404,确保它真在索引里(Windows 记事本可能悄悄加 BOM) - Jekyll 用户需在
404.html开头加---permalink: /404.htmlpublished: false---,否则会被当成普通文章渲染 - Linux 服务器区分大小写,macOS 默认不区分——开发时没问题,上线后可能突然失效
HTML 结构里哪些标签和内容不能省
搜索引擎和屏幕阅读器靠结构识别这是错误页,不是靠视觉样式。以下三处是硬性语义要求:
立即学习“前端免费学习笔记(深入)”;
-
<title></title>必须含 “404”,如<title>404 - 页面未找到</title>,否则搜索结果点进来像进了首页 -
<h1></h1>必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是图片、SVG 文本或 JS 渲染内容 - 主内容必须包裹在
<main></main>内(或加role="main"),让辅助技术跳过导航直接读错误信息 - 返回首页链接必须用
<a href="/">← 返回首页</a>,禁用<button onclick="location.href='/'"></button>—— JS 被禁用时按钮就失效
CSS 和资源加载必须内联且极简
外部 CSS/JS 在 404 场景下极易失败:CDN 不可用、路径错乱、SPA fallback 规则吞掉请求,最终导致白屏或只剩文字。
- CSS 必须写进
<style></style>标签,控制在 1KB 以内;禁用<link rel="stylesheet"> - 所有图片用根相对路径(如
/img/404-icon.svg)或 data URL,避免./assets/icon.png这类相对路径在/blog/post/xxx下失效 - 字体用系统默认栈:
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif - 文字与背景对比度 ≥ 4.5:1,可用 webaim.org/contrastchecker 验证
- 禁用
<meta http-equiv="refresh">和setTimeout(() => location.href = '/', 2000)—— 干扰后退、对无障碍不友好、SEO 误判为正常页
最容易被忽略的点:状态码是否真实返回,比页面多炫酷重要十倍。很多团队花半天调灯光动画,却没验证过 curl -I 第一行是不是 404 Not Found —— 那整个页面就只是个带“404”字样的普通 HTML。



















