404页面生效的前提是服务器返回HTTP 404状态码,而非仅存在404.html文件;必须通过HTTP服务访问并用curl -I验证响应头,静态托管平台对文件名、路径、大小写、BOM等有严格要求,SPA需避免路由规则吞掉404,HTML须原生可访问且标题文案明确。

404页面不是“写好HTML放上去就生效”的静态文件,而是服务器、路径、状态码、HTML结构四者严格协同的结果。光有404.html却没配对的HTTP 404响应,90%的情况浏览器看到的是200 OK——它根本不会当这是错误页。
确认服务器是否真返回 404 Not Found 状态码
这是所有问题的前提。本地双击打开404.html或用file:///协议访问,永远不触发真实404;必须走HTTP服务(如http://localhost:3000/nonexistent)才能验证。
- 用
curl -I http://your-site.com/xxx检查响应头,必须看到HTTP/1.1 404 Not Found,而不是200 OK或302 Found - GitHub Pages只在根路径下识别
/404.html,访问/docs/xxx会触发,但/docs/404.html不会被当作错误页接管 - Netlify支持
_redirects文件写/* /404.html 404,比单纯放文件更可靠——它强制所有未命中路径返回404状态码 - Vercel需在
vercel.json中配置rewrites并确保不覆盖正常路由,Next.js项目推荐用notFound: true而非硬跳转
404.html 文件名与位置必须精确匹配平台规则
大小写、扩展名、路径层级,错一个字符就失效。静态托管平台不解析逻辑,只做字符串匹配。
- 文件名必须是小写
404.html:不是404.htm、Error404.html、404.HTML,也不能带空格或BOM(Windows记事本易加BOM,可用git ls-files | grep 404确认Git提交内容) - 必须放在项目根目录:和
index.html同级,pages/404.html或src/404.html均无效 - Jekyll用户需在
404.html开头加YAML front matter:---\npermalink: /404.html\npublished: false\n---,否则会被渲染为普通页面 - SPA应用(React/Vue)的
try_files $uri $uri/ /index.html规则会吞掉所有404,必须排除/404.html路径,例如Nginx中加location = /404.html { }
HTML结构必须原生可访问,禁用JS依赖
用户可能禁用JS、网络中断、或页面加载一半失败。核心信息必须不靠脚本呈现。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
-
<h1>404</h1>必须存在且为一级标题,不能是图片、SVG文本或JS动态插入;加aria-label="404"仅作补充,不可替代文字节点 - 展示原始请求路径:
<script>document.write(location.pathname)</script>,帮助用户确认拼写错误 - 搜索框用纯
<form method="GET" action="/search"><input name="q"></form>,不绑onsubmit或preventDefault——无JS时仍能提交 - 返回首页用
<a href="/">← 返回首页</a>,不用<button onclick="history.back()"></button>——外链进来的用户点它会跳空页
动画跳转要同步、可中断、不骗搜索引擎
自动跳转若无停留、无提示,Google会判为“软404”,影响收录。趣味效果必须守住底线。
- 动画结束后再跳转:CSS定义
@keyframes jump-in { to { transform: scale(1) translateY(0); } },JS用setTimeout(() => location.replace("/"), 600)确保时长一致 - 给
body加transition: none初始态,防止首次加载意外触发过渡 - 页面标题保持
<title>404 - 页面不存在</title>,不能改成“正在跳转…” - 保留可见文案:
<h1>404</h1> <p>找不到你要的页面</p>,让用户看清状态再离开
最容易被忽略的点是:你以为自己在调试HTML,其实是在调试服务器配置。状态码不对,后面所有样式、动画、跳转都白搭——先让curl -I返回真实的404 Not Found,再动其他。


















