404页面必须由服务器真实返回404 Not Found状态码,否则无效;本地双击打开仅走file://协议,无HTTP状态码,显示的“404”仅为文字提示,非真实错误响应。

404页面不是“写个提示就行”,它必须由服务器真实返回 404 Not Found 状态码,否则对 SEO、用户感知和爬虫行为都是干扰项。
为什么本地双击 404.html 永远不是真 404
file:// 协议下没有 HTTP 状态码概念,浏览器加载的是 200 OK。你看到的“404”只是文字,不是错误响应。
- 验证必须走真实 HTTP:用
npx serve -s或python3 -m http.server 8000启服务,再访问一个不存在路径(如/xxx-abc) - 打开 DevTools → Network → 找该请求 → 看
Status是否为404 Not Found - 命令行更准:
curl -I http://localhost:8000/xxx-abc,第一行必须是HTTP/1.1 404 Not Found
文件名、位置、路径三要素不能错
静态托管(GitHub Pages / Vercel / Netlify)只认根目录下的严格小写 404.html —— 多一个字母、大写、子目录、隐藏字符都会失效。
- 文件名必须是
404.html(全小写,无空格,无 BOM),不能是404.htm、not-found.html或pages/404.html - 必须与
index.html同级,放在项目根目录 - CSS、图片等资源要用根相对路径:
/css/style.css,而非./css/style.css或css/style.css(深层 URL 下会 404 加载失败) - Jekyll 用户需在开头加
---前置数据:permalink: /404.html+published: false
HTML 结构和内容的硬性要求
搜索引擎和屏幕阅读器靠语义识别这是错误页,不是普通内容页。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
-
<title></title>必须含 “404”,如<title>404 - 页面未找到</title> -
<h1></h1>必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是图片、SVG 文本或 JS 渲染 - 主体用
<main></main>包裹,或加role="main" - 至少提供一个有效跳转:首页链接文字写 “← 返回首页”,别用 “Click here”
- 加
<meta name="robots" content="noindex">,防止被搜索引擎误收录
样式必须内联且极简,禁用 JS 跳转逻辑
外部资源加载失败时,页面可能只剩白底黑字;JS 跳转则违反 SEO 和可访问性底线。
- CSS 写进
<style></style>标签,控制在 1KB 内;禁用<link rel="stylesheet"> - 字体栈用
-apple-system, sans-serif,不依赖 Web Font - 避免
@import、背景图、Flex/Grid 复杂布局(IE11/旧 WebView 兼容风险) - 禁用
<meta http-equiv="refresh">和setTimeout(() => location.href = '/', 2000) - “返回首页”必须是纯
<a href="/"></a>,不要<button onclick="..."></button>
最容易被忽略的一点:SPA 应用(React/Vue)的 try_files $uri $uri/ /index.html 规则会吞掉所有 404,必须显式排除 /404.html 路径,否则你写的 HTML 根本不会被服务器触发。


















