必须由服务器真实返回404状态码,否则搜索引擎误收录、用户无感知;需用curl -I或DevTools Network面板验证响应头为“HTTP/1.1 404 Not Found”,且页面内容确为自定义404.html。

404页面不是“写个HTML放上去就生效”,它必须由服务器真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户刷新无感知、DevTools里看到的永远是 200 OK。
怎么确认你的404.html真被服务器用了
本地双击打开 404.html 文件毫无意义——file:// 协议根本没有 HTTP 状态码。验证只看三点:
- 用
curl -I https://yoursite.com/xyz123,第一行必须是HTTP/1.1 404 Not Found - 在 Chrome DevTools 的
Network面板里访问一个明显不存在的路径(如/nonexistent),检查响应头中Status是404,且Content-Type是text/html - 页面内容是你写的
404.html,不是托管平台默认页(如 GitHub 的 “There isn’t a GitHub Pages site here.”)
常见失效原因:GitHub Pages 必须严格命名为小写 404.html 并放在仓库根目录;Nginx 的 error_page 404 /404.html 被 try_files $uri $uri/ /index.html 拦截;Apache 的 ErrorDocument 404 ./404.html 路径写错导致 404 文件本身找不到。
HTML结构里哪些标签和文字不能省
404.html 是服务端注入的错误响应体,不是普通网页。语义和可访问性是硬门槛:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
必须含 “404”,例如,否则搜索引擎当首页索引404 - 页面未找到 -
必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是图片、SVG 文本或 JS 渲染内容 - 核心内容用
包裹,或加role="main",让屏幕阅读器跳过导航直读错误信息 - 返回首页用
@#@#@#@#@#@#@#@#@#@0,不是—— JS 关闭时仍要可用 - 加
,防止被搜索引擎误收录
CSS必须内联,且控制在1KB以内
外部 CSS 加载失败 = 白屏。404 可能发生在任意子路径(如 /blog/post/xxx),此时 ./css/style.css 会 404,连带你的样式全丢。实操底线:
- 所有样式写进
,删空格、注释、@import,确保 ≤ 1KB - 字体栈用系统默认:
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif - 文字与背景对比度 ≥ 4.5:1(可用
webaim.org/contrastchecker验证) - 避免背景图、动画、Flex/Grid 复杂布局——IE11 和旧安卓 WebView 不一定支持
- 图片用根相对路径(如
/img/404-icon.svg)或 data URL,禁用这类额外请求
搜索框和跳转逻辑必须降级可用
用户进 404 页面平均停留不到 8 秒,任何 JS 依赖都可能卡死或白屏。所谓“功能”,只是把输入转发给已有搜索页:
- 用标准
,input必须带name="q",否则提交后 URL 里没查询参数 - 给
input加autofocus,回车默认触发表单提交,不写onsubmit="return false" - “回到上一页”按钮需先判断:
document.referrer是否同域且非空,否则置灰或隐藏 - 禁用
和setTimeout(() => location.href = '/', 2000)—— 它们会让状态码变成200,破坏 SEO
最易被忽略的点:SPA 应用(React/Vue)的路由 fallback 规则常把所有 404 吞掉,返回 200 OK 的 index.html,必须显式排除 /404.html 路径。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










