404页面必须真实返回404状态码,文件名严格为根目录下小写404.html且无BOM;HTML需含语义化标签、内联CSS、绝对路径资源及禁止自动跳转,SPA须排除/404.html路径避免被重写。

404页面不是“写个HTML放上去就完事”,它必须由服务器真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户刷新无反馈、无障碍工具无法识别错误意图。
如何确认你的 404 页面真返回了 404 状态码
本地双击打开 404.html 是 200 OK,毫无意义。必须走 HTTP 协议验证:
- 用
npx serve -s启服务,访问http://localhost:3000/nonexistent-path - 打开 DevTools → Network → 找该请求 → 看
Status是否为404 Not Found - 更准的方式是命令行:
curl -I http://localhost:3000/nonexistent-path,第一行必须是HTTP/1.1 404 Not Found - 若看到
302 Found或200 OK,说明服务器配置失败,页面再漂亮也白搭
静态托管平台的 404.html 文件必须严格满足三项硬约束
GitHub Pages、Vercel、Netlify、Cloudflare Pages 都只认一个名字、一个位置、一种写法:
- 文件名必须是纯小写
404.html(不能是404.htm、error404.html、404.HTML) - 必须放在项目根目录(和
index.html同级),不能在pages/或src/下 - Git 提交时不能带 BOM:用
git ls-files | grep 404确认存在,Windows 记事本保存易加 BOM,建议用 VS Code 保存为 UTF-8 无 BOM
HTML结构里哪些标签和内容不能省
这不是普通网页,而是错误响应体,语义和可访问性是硬指标:
-
必须含 “404”,例如,否则搜索结果点进来像进了首页404 - 页面未找到 -
必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是图片、SVG 文本或 JS 渲染内容 - 主内容必须包裹在
或加role="main",让屏幕阅读器跳过导航直接读错误信息 - 加
,防止被搜索引擎误收录
CSS 和跳转逻辑必须零外部依赖
404 页面常出现在资源路径错误时(比如 /assets/main.css 本身 404),任何外部请求都可能失败:
- CSS 必须内联在
中,控制在 1KB 以内;禁用 - 所有图片用 data URL 或绝对根路径(如
/img/404-icon.svg),避免相对路径在深层 URL 下失效 - “返回首页”必须用
@#@#@#@#@#@#@#@#@#@0,不是 - 禁用
和setTimeout(() => location.href = '/', 2000),它们会返回 200 状态,且对无障碍不友好
最常被忽略的一点:SPA 应用(React/Vue)的 location / { try_files $uri $uri/ /index.html; } 规则会吞掉所有 404,必须显式排除 /404.html 路径——否则你写的 404.html 永远不会被服务器真正返回。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











