光写一个404.html文件90%不会生效,必须将其严格命名为小写、置于根目录(与index.html同级),并确保服务器真实返回HTTP 404状态码;静态平台仅识别/404.html,禁用JS渲染、跳转及外部资源,HTML须原生可访问。

光写一个 404.html 文件,90% 的情况下根本不会生效——服务器默认不认它,浏览器本地双击打开更是完全无效。
文件名和位置必须严格匹配
静态托管平台(GitHub Pages、Vercel、Netlify、Cloudflare Pages)只识别根目录下、全小写的 404.html。任何偏差都会导致失效:
-
404.htm、404.HTML、error-404.html都不行 -
/pages/404.html或/src/404.html也不行,必须和index.html同级 - Windows 记事本可能偷偷加 BOM 头,用 VS Code 或 Sublime 打开确认编码是 UTF-8 无 BOM
- Git 用户执行
git ls-files | grep 404,确保它真被提交了,不是被 .gitignore 忽略了
验证是否真返回 404 状态码
页面显示“404”不等于它是真正的 404 页面。必须确认服务器返回的是 HTTP/1.1 404 Not Found,而不是 200 OK:
- 别双击打开
404.html——file://协议没有状态码概念 - 本地启动 HTTP 服务:
npx serve -s或python3 -m http.server 8000 - 访问一个肯定不存在的路径,比如
http://localhost:8000/xxx-abc - 打开 DevTools → Network → 找该请求 → 看 Response Headers 里
Status是否为404 Not Found - 更准的方式:
curl -I http://localhost:8000/xxx-abc,第一行必须是HTTP/1.1 404 Not Found
HTML 结构不能靠 JS 渲染
用户可能禁用 JS、网络中断、或页面加载到一半失败。核心信息必须原生可读:
-
必须含 “404”,例如404 - 页面未找到 -
必须直写 “404 Not Found”,不能是图片、SVG 文本或<script></script>插入 - 主内容用
包裹,或加role="main",让屏幕阅读器跳过导航直接读错误信息 - 返回首页用
@#@#@#@#@#@#@#@#@#@0,别用 - 想显示当前请求路径?可以用
,但别依赖它做跳转逻辑<script>document.write(location.pathname)</script>
CSS 必须内联且极简
外部 CSS 加载失败,页面就会白屏或只剩文字。所有样式必须塞进 标签:
- 控制在 1KB 以内,只保留字体、间距、颜色、居中四类规则
- 用根相对路径引用图片:
/img/404-icon.svg,不是./img/404-icon.svg(深层路径下会 404) - 避免
@import、背景图、Web Font —— 它们触发额外请求,增加失败概率 - 文字与背景对比度 ≥ 4.5:1,可用 webaim.org/contrastchecker 验证
- 别加
或setTimeout自动跳转,干扰后退且对无障碍不友好
最容易被忽略的一点:SPA 应用(React/Vue)的路由 fallback 规则常把所有 404 吞掉,返回 200 的 index.html。必须显式排除 /404.html 路径,否则你写的 404.html 永远不会被服务器真正返回。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











