404.html必须严格置于根目录且全小写命名,服务器需返回真实HTTP 404状态码,HTML须含语义化纯文本“404”、内联CSS≤1KB、无外链资源,并确保SEO与可访问性合规。

404.html 文件必须放根目录且命名严格小写
GitHub Pages、Vercel、Netlify、Cloudflare Pages 这些平台只识别 404.html 这个确切文件名,且必须位于项目仓库或站点的**根目录**。写成 404.htm、error404.html、pages/404.html 或 404.HTML 都会失效——服务器压根不会接管它作为错误页。
常见错误现象:文件看着放对了,但访问不存在路径时仍显示平台默认灰页(比如 GitHub 的 “404 There isn’t a GitHub Pages site here.”)。
- 用
git ls-files | grep 404检查 Git 是否真提交了该文件(Windows 记事本可能悄悄加 BOM) - Jekyll 用户需在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被当成普通页面渲染 - 确认文件名是纯小写,无空格、无隐藏字符(可用
ls -la查看)
服务端必须返回真实 HTTP 404 状态码
光有 404.html 文件毫无意义。关键是要让服务器在资源不存在时,返回 HTTP 状态码 404 Not Found,同时响应体是你写的 HTML —— 而不是用 302/301 重定向过去,更不能让它悄悄变成 200 OK。
常见错误现象:浏览器控制台显示 Failed to load resource: the server responded with a status of 200 OK,但 URL 是 /xxx/xxx;或 Google Search Console 把你的 404.html 当作普通页面收录。
- Apache:
.htaccess中写ErrorDocument 404 /404.html,路径必须以/开头 - Nginx:在
server块中加error_page 404 /404.html;,并确保location = /404.html存在且未被其他rewrite规则覆盖 - SPA 应用(React/Vue)要特别注意:
location / { try_files $uri $uri/ /index.html; }这类 fallback 会把所有 404 吞掉,返回 200 的index.html,必须排除/404.html路径
HTML 结构必须语义化且含纯文本 “404”
搜索引擎和屏幕阅读器靠标签结构识别页面意图。 不只是样式需要,更是可访问性和 SEO 的硬性要求。用图片、SVG 文本或 JS 动态插入 “404” 字样的方式都不可靠。404 Not Found
常见错误现象:页面看着像 404,但 Google 把它当普通页面索引;视障用户听到的是 “网页标题”,而非 “404 页面未找到”。
- 必须用
包裹核心内容,让辅助技术跳过导航直读错误信息 -
中必须含 “404” 字样,缺字即被误判为普通页404 - 页面未找到 - CSS 必须内联且 ≤1KB,外链 CSS 在深层路径下大概率触发二次 404,导致白屏
- 图片全用内联 SVG 或 data URL,
在/blog/post/xxx下会请求/blog/post/img/404.svg,直接失败
跳转逻辑必须兼顾动画同步与 SEO 合规
若想做“趣味跳入”效果,本质是用 CSS 动画触发位移或缩放,再配合 JS 跳转。关键不是动画多炫,而是动画结束后再跳转,否则用户看到一半就白屏了。
Google 明确表示:如果 404 页面自动跳转且无停留、无提示,会被视为软 404,影响收录。所以“趣味跳入”必须满足两个底线:用户能看清这是 404,且有手动操作入口。
- 给
加class="jump-in",CSS 定义@keyframes jump-in,动画时长设为0.6s - JS 用
setTimeout(() => { location.replace('/'); }, 600)确保同步,且必须放在DOMContentLoaded后 - 务必加
transition: none到body.jump-in的初始状态,防首次加载意外触发过渡 - 必须保留可见文字,例如
,并提供纯404
找不到你要的页面
@#@#@#@#@#@#@#@#@#@0链接
最容易被忽略的一点:所有样式必须塞进 标签,不能依赖外部资源;所有跳转必须用 location.replace 而非 location.href;所有“404”字样必须是 DOM 中的纯文本节点,不能由 JS 插入、不能藏在 SVG 或 canvas 里。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











