404.html必须严格小写并置于网站根目录,服务器须返回真实HTTP 404状态码,HTML中和须含纯文本“404”,CSS需内联且极简,禁止JS依赖与外部资源。

404.html 文件名和位置必须严格匹配
服务器只认 404.html 这个确切文件名,且必须放在网站根目录(和 index.html 同级)。写成 404.htm、error-404.html、pages/404.html 或 404.HTML 都不会被识别。
常见失效现象:文件明明存在,但访问 /nonexistent 时仍看到托管平台默认的灰色错误页(比如 GitHub 的 “There isn’t a GitHub Pages site here.”)。
- 用
git ls-files | grep 404确认 Git 已提交该文件(Windows 记事本可能加 BOM 导致静默失败) - Jekyll 用户需在
404.html开头加 front matter:---\npermalink: /404.html\npublished: false\n---,否则会被当作普通页面渲染 - Netlify 用户可在
_redirects文件里写:/* /404.html 404
HTML 结构必须含语义化标签和“404”文字
<h1></h1> 和 <title></title> 里必须直写 “404”,不能靠图片、SVG 或 JS 插入。搜索引擎和屏幕阅读器依赖这些文本判断页面性质。
主内容必须包裹在 <main></main> 里(或加 role="main"),否则视障用户无法跳过导航直达错误信息。
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
<title>404 - 页面未找到</title>(不是 “Oops!” 或空 title) -
<h1>404 Not Found</h1>(必须是纯文本,不可用<img alt="怎么用基础HTML代码搭建404页面" >或 CSS::before生成) - 返回链接文字写 “← 返回首页”,别写 “Click here” 或按钮
- 加
<meta name="robots" content="noindex">,防止被搜索引擎误收录
CSS 必须内联且极简,禁用外部资源
外部 CSS、JS、图片链接在 404 场景下大概率失败——CDN 挂了、路径解析错(比如从 /blog/post/xxx 加载 ./css/style.css 会 404)、或安全策略拦截,导致白屏。
所有样式必须写进 <style></style> 标签,控制在 1KB 内,只保留字体、间距、颜色、居中四类规则。
- 用根相对路径引用图片:
/img/404-icon.svg,不用./img/或../img/ - 字体栈写
-apple-system, sans-serif,不依赖 Web Font - 禁用
@import、背景图、Flex/Grid 复杂布局(IE11 和旧 WebView 不支持) - 文字与背景对比度 ≥ 4.5:1,可用 webaim.org/contrastchecker 验证
状态码必须真实为 404,不能靠跳转掩盖
光有 404.html 文件毫无意义。关键是要让服务器对无效路径(如 /xxx)返回 HTTP 状态码 404 Not Found,响应体才是你的 HTML —— 而不是返回 200 OK 后再用 JS 或 <meta http-equiv="refresh"> 跳转。
验证方式:启动本地服务(如 npx serve -s),访问 http://localhost:5000/nonexistent,打开 DevTools → Network → 查看该请求的 Response Headers 中 Status 是否为 404 Not Found;或用 curl -I https://yoursite.com/nonexistent 看第一行。
- Apache:
ErrorDocument 404 /404.html(路径必须以/开头) - Nginx:
error_page 404 /404.html;,并确保location = /404.html存在且未被 rewrite 覆盖 - SPA 应用(React/Vue)要排除
/404.html:在try_files $uri $uri/ /index.html;前加if ($request_uri ~ ^/404\.html$) { break; }或类似逻辑
最容易被忽略的是:本地双击打开 404.html 完全无效——file:// 协议没有 HTTP 状态码。一切验证必须走真实 HTTP 服务。


















