404页面必须由服务器真实返回404状态码,且文件名、位置、结构、样式均需严格合规:根目录下全小写404.html,语义化HTML(含404 Not Found、含404、包裹)、内联CSS≤1KB、禁用JS跳转与外部资源,验证须通过curl或DevTools确认Status为404 Not Found。

404页面不是“写个HTML放上去就行”,核心在于服务器必须真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户刷新无提示、爬虫无法识别死链。
404.html 文件名和位置必须严格合规
静态托管平台(GitHub Pages、Vercel、Netlify、Cloudflare Pages)只识别根目录下、全小写的 404.html —— 写成 404.htm、error-404.html、pages/404.html 或 404.HTML 都无效。
- 用
git ls-files | grep 404检查 Git 是否真提交了该文件(Windows 记事本可能加 BOM 导致静默失败) - Jekyll 用户需在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被当作普通文章渲染 - 文件必须和
index.html同级,不能嵌套在子目录里
服务器必须返回真实 404 状态码,不能是 200 或 302
本地双击打开 404.html 是 file:// 协议,压根没有 HTTP 状态码——这根本不是 404 页面。验证只看两点:curl -I https://yoursite.com/nonexistent 返回首行是 HTTP/1.1 404 Not Found;或 Chrome DevTools → Network → 访问一个明显不存在的路径(如 /xyz-abc),确认 Status 列为 404 Not Found。
- Apache:在
.htaccess中写ErrorDocument 404 /404.html,路径必须以/开头,不能是./404.html - Nginx:在
server块中加error_page 404 /404.html;,并确保location = /404.html存在且未被try_files规则覆盖 - SPA 应用(React/Vue):常见错误是
location / { try_files $uri $uri/ /index.html; }把所有 404 吞掉,必须排除404.html路径,例如try_files $uri $uri/ /index.html =404;
HTML 结构必须语义化,且不含 JS 依赖
搜索引擎和屏幕阅读器靠标签结构识别意图。<h1>404 Not Found</h1> 不只是样式需要,更是硬性要求——用图片、SVG 文本或 JS 动态插入都不可靠。
立即学习“前端免费学习笔记(深入)”;
-
<title></title>必须含 “404”,例如<title>404 - 页面未找到</title>,否则搜索结果点进来像进了首页 - 核心内容必须包裹在
<main></main>内,或加role="main",让屏幕阅读器跳过导航直读错误信息 - “返回首页”必须用
<a href="/">← 返回首页</a>,不能是<button onclick="location.href='/'"></button>—— JS 关闭时仍要可用 - 禁用
<meta http-equiv="refresh">和自动跳转 JS,它们会让状态码变成 200,破坏 SEO
CSS 必须内联且 ≤1KB,禁用外部资源
外链 CSS 加载失败 = 白屏。404 可能发生在任意子路径(如 /blog/post/xxx),相对路径会失效;CDN 挂了、安全策略拦截脚本,都会导致降级失败。
- 所有样式写进
<style></style>标签,删空格、注释、@import,控制在 1KB 以内 - 字体栈用系统默认:
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif - 文字与背景对比度 ≥ 4.5:1(可用 webaim.org/contrastchecker 验证)
- 图片用根相对路径(如
/img/404-icon.svg)或 data URL,避免./icon.png在深层路径下 404
最容易被忽略的是:你改好了 HTML 和 Nginx 配置,但没清 Service Worker 缓存,或者 PWA 把旧的 200 响应缓存了——此时浏览器看到的仍是“假 404”。上线前务必在隐身窗口 + 禁用缓存模式下验证 Network 面板里的真实状态码。



















