服务器必须返回真实404状态码，否则404.html无效；需用curl -I或DevTools Network验证响应头是否为HTTP/1.1 404 Not Found；Apache配ErrorDocument、Nginx配error_page+internal、GitHub Pages仅认根目录小写404.html；HTML须内联样式、语义化结构、禁用JS依赖。

html搭建404页面的思路与做法

服务器必须返回真实 404 状态码，否则页面无效

光有 404.html 文件，90% 的情况不会触发真正的 404 行为。浏览器和搜索引擎只认 HTTP 响应头里的 HTTP/1.1 404 Not Found，不是看文件名或页面文字。

验证方式只有两种：curl -I http://localhost/nonexistent-path 看第一行；或在 DevTools Network 面板里检查目标请求的 Status 是否为 404。

Apache：确认 .htaccess 含 ErrorDocument 404 /404.html，且 mod_alias 已启用
Nginx：error_page 404 /404.html; 必须配 location = /404.html { internal; }，否则直连该路径会返回 200
GitHub Pages：只认根目录下严格命名为 404.html（小写、无空格、无 BOM），且仅对顶层路径生效（/foo/bar 触发，/docs/404.html 不触发）
SPA 应用（React/Vue）：try_files $uri $uri/ /index.html; 这类 fallback 会吞掉所有 404，必须排除 /404.html 路径

HTML 文件必须放对位置、命名严格、结构语义化

404.html 不是随便扔哪都行的普通页面。静态托管平台（GitHub Pages、Vercel、Netlify、Cloudflare Pages）全部只识别仓库根目录下的小写 404.html —— 写成 404.htm、pages/404.html、404.HTML 或带空格，全都不生效。

结构上不能靠 JS 渲染关键信息：

`404`

必须是纯文本，不能是 SVG、图片或 document.write() 插入；或 role="main" 必须包裹主内容，保障屏幕阅读器可访问。

必须含 “404”，如 404 - 页面未找到
加，防止被搜索引擎误收录
展示用户原访问路径：<script>document.write(location.pathname)</script>，帮助排查拼写错误
导航链接统一用绝对路径，比如 @#@#@#@#@#@#@#@#@#@0，别用 history.back() —— 外链进来的 404 点它会跳空页

CSS 和资源必须内联，禁用外部依赖

404 页面常出现在资源路径本身出错时（比如 /assets/main.css 404），若页面再请求外部 CSS、JS 或图片，就会引发更多失败请求，导致白屏或只剩文字。

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

所有样式必须写在标签里，控制在 1KB 以内；字体优先用系统默认栈；图片用 data URL 或绝对根路径（如 /img/404-icon.svg）。