404页面必须由服务器真实返回404状态码,否则无效;静态托管需严格命名404.html并正确配置;Apache/Nginx须显式设置错误页;HTML须语义化、零JS依赖、内联CSS≤1KB、高对比度、根路径资源。

404页面不是“写个HTML放上去就行”,它必须由服务器真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户无法识别死链、所有前端美化都白费。
确认你的托管平台是否自动支持404.html
GitHub Pages、Vercel、Netlify、Cloudflare Pages 这类静态托管,只认根目录下严格小写的 404.html 文件名。写成 404.htm、pages/404.html、404.HTML 或带空格/隐藏字符,全都不生效。
- 用
git ls-files | grep 404检查 Git 是否真提交了该文件(Windows 记事本可能加 BOM) - Jekyll 用户需在文件开头加
---\npermalink: /404.html\npublished: false\n---,否则会被当作普通页面渲染 - 上传后访问一个明显不存在的路径(如
/xyz-abc),打开 DevTools → Network → 查响应头第一行是否为HTTP/1.1 404 Not Found
Apache 和 Nginx 必须显式配置错误页接管
不配就永远返回默认 404 或直接 200,你的 HTML 压根不会被加载。
- Apache:在
.htaccess中写ErrorDocument 404 /404.html,路径必须以/开头,不能是./404.html或带域名 - Nginx:在
server块中加error_page 404 /404.html;,并确保location = /404.html存在且未被try_files规则覆盖(常见坑:SPA 的try_files $uri $uri/ /index.html;会吞掉所有 404) - 验证方式:用
curl -I https://yoursite.com/nonexistent,第一行必须是HTTP/1.1 404 Not Found
HTML结构必须语义化且零JS依赖
用户平均停留不到 8 秒,任何 JS 加载失败、被拦截或禁用,都会让按钮失灵、文字错位甚至白屏。
立即学习“前端免费学习笔记(深入)”;
-
<title></title>必须含 “404”,例如<title>404 - 页面未找到</title>,否则搜索引擎当首页索引 -
<h1></h1>必须直写 “404 Not Found” 文字,不能是图片、SVG 或 JS 动态插入 - 核心内容用
<main></main>包裹,加role="main",让屏幕阅读器跳过导航直读错误信息 - 返回首页必须用
<a href="/">回到首页</a>,不是<button onclick="location.href='/'"></button> - 禁用
<meta http-equiv="refresh">和setTimeout(() => location.href = '/', 2000),它们会让状态码变成 200
CSS必须内联且控制在1KB以内
外部 CSS 加载失败 = 白屏。移动端弱网下资源超时概率高,所有样式必须塞进 <style></style> 标签。
- 字体用系统栈(如
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;) - 文字与背景对比度 ≥ 4.5:1,可用 webaim.org/contrastchecker 验证
- 图片用绝对根路径(如
/img/404-icon.svg)或 data URL,避免相对路径在深层 URL 下失效 - 禁用
<link rel="stylesheet">、第三方字体、CDN 脚本——它们极大概率加载失败
最常被忽略的一点:你写的 HTML 再完美,只要服务器没返回真实 404 状态码,它就只是个普通网页,不是 404 页面。



















