404页面核心是服务器真实返回404状态码,文件名必须为小写404.html且置于根目录,HTML需语义化、内联样式、自包含资源,并验证HTTP响应头确为404 Not Found。

404页面不是“写个HTML放上去就行”,核心卡点永远在服务器是否真实返回 404 Not Found 状态码——没这一步,其他全是白忙。
404.html 文件必须严格小写、放根目录、不参与构建
GitHub Pages、Netlify、Vercel、Cloudflare Pages 这些平台只认 404.html 这个确切文件名,且必须和 index.html 同级。写成 404.htm、error404.html、pages/404.html 或 404.HTML 都不会被接管。
- 用
git ls-files | grep 404检查 Git 是否真提交了该文件(Windows 记事本可能悄悄加 BOM) - Jekyll 用户需在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被渲染为普通文章 - 别把它放进 Webpack/Vite 构建流程——它必须是静态独立文件,不能被 hash、不能被路由拦截
验证状态码:别信页面长什么样,只信 Network 面板
本地双击打开 404.html 是 200 OK,毫无意义。必须走真实 HTTP 请求验证:
- 用
npx serve -s或python3 -m http.server 8000启服务,访问http://localhost:8000/asdf123 - 打开 DevTools → Network → 找该请求 → 看 Response Headers 中的
Status是否为404 Not Found - 命令行更准:
curl -I https://yoursite.com/nonexistent,第一行必须是HTTP/1.1 404 Not Found
如果看到状态码是 200 或 302,说明服务器配置没生效,不是 HTML 写得不对。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
HTML 结构必须语义化且自包含
404.html 是服务器直接注入的响应体,不能依赖任何外部资源或 JS 执行逻辑:
-
<title></title>必须含 “404”,例如<title>404 - 页面未找到</title> -
<h1></h1>必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是 SVG 文本、伪元素或 JS 渲染 - 所有样式必须内联在
<style></style>标签里,禁止<link rel="stylesheet"> - 图片用根相对路径(如
/img/404-icon.svg)或 data URL,禁用相对路径(./img/...在/blog/post/xxx下会失效) - 导航链接全部以
/开头,例如<a href="/"></a>,避免嵌套 404
服务器配置最容易漏掉的三个细节
静态托管平台大多自动支持,但自建 Nginx/Apache 或 SPA 应用极易出错:
- Nginx:必须同时写
error_page 404 /404.html;和location = /404.html { },否则会被try_files $uri $uri/ /index.html;拦截并返回200 - Apache:
ErrorDocument 404 /404.html必须以/开头,不能写成./404.html;且要放在伪静态规则末尾,防止被覆盖 - React/Vue SPA:确保路由 fallback 规则排除
/404.html,例如 Nginx 中改写为try_files $uri $uri/ /index.html =404;或加条件判断
最常被忽略的是:404 页面本身不能触发二次 404——比如引用了不存在的 /css/main.css,会导致白屏或只剩文字。


















