404.html文件必须置于根目录且小写命名,服务器需配置error_page或ErrorDocument并返回真实404状态码,禁用跳转、内联样式,确保SPA不覆盖,且页面自身访问时也返回404状态。

直接放一个 404.html 文件到网站根目录,浏览器访问不存在路径时并不会自动显示它——服务器根本不会主动返回这个文件,除非你明确告诉它“遇到 404 就用这个页面”。关键不是文件存在,而是服务器怎么响应错误状态。
为什么本地双击打开 404.html 没用
双击用浏览器打开 404.html 是在 file:// 协议下运行,不经过任何服务器,也就没有 HTTP 状态码概念。此时无论你怎么命名文件、写什么内容,都和真正的 404 错误页无关。真正在意的是:当用户请求 /nonexistent-page,服务器返回 404 状态码的同时,是否把你的 404.html 当作响应体发出去。
- 静态托管平台(如 GitHub Pages、Vercel、AxureShow)通常内置默认 404 页,但只接受固定命名:
404.html(必须全小写、无路径、在根目录) - 自己搭的 Nginx/Apache 需手动配置
error_page 404 /404.html,且确保该文件能被正常读取(权限、MIME 类型、路径拼接) - 前端 SPA(Vue/React)若用 history 模式,Nginx 的
try_files会先兜底到index.html,导致真实 404 请求也被前端接管——这时你的404.html根本没机会触发
Nginx 下配置 404 页面的硬性要求
不是加一行 error_page 就完事。它依赖 root 路径、文件位置、权限三者严丝合缝:
-
error_page 404 /404.html;中的/404.html是相对于root指令定义的路径,不是文件系统绝对路径 - 假设
root /var/www/html;,那你的404.html必须放在/var/www/html/404.html,不能在子目录里 - 该文件需被 Nginx 工作进程可读(属组通常是
www-data或nginx),执行ls -l /var/www/html/404.html确认权限至少是-rw-r--r-- - 别漏掉
location = /404.html { }块——否则可能被其他 location 规则拦截,比如被location /的try_files兜底走掉
静态托管平台(GitHub Pages/Vercel)的隐含规则
它们不让你改服务器配置,但约定俗成地识别特定文件名:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- GitHub Pages:只认根目录下的
404.html,大小写敏感;如果放成404.htm或pages/404.html,一律返回默认白板页 - Vercel:同样只认
404.html,但允许你在vercel.json里覆盖:{"rewrites": [{"source": "/(.*)", "destination": "/404.html"}]}——不过这其实是把所有 404 变成 200,慎用 - AxureShow 等国内托管平台:部分会忽略
404.html,转而强制返回平台定制页;此时唯一办法是前端路由层捕获 404(如 Vue Router 的beforeEach+router.push('/404')),但 URL 会变,状态码仍是 200
404 页面内容本身要注意什么
它不只是“页面不存在”的提示,更是防止用户流失的最后一道防线:
- 别写“抱歉,页面丢了”,用中性表述如“您访问的页面暂不可用”或“链接可能已失效”
- 必须包含清晰导航:首页链接、搜索框、最近更新文章列表(如果适用)、联系方式——别让用户只能点返回按钮
- 避免引用外部 CSS/JS,防止因资源 404 导致页面样式崩坏;内联关键样式更稳妥
- 不要自动跳转(
<meta http-equiv="refresh">),既影响 SEO,也打断用户操作流 - 如果网站有深色模式,
404.html也应支持,否则在暗色系统下文字可能看不见
最常被忽略的一点:404 页面本身必须能被直接访问并返回 404 状态码。上线前务必手动请求一次 https://yoursite.com/404.html,看响应头里是不是真的 Status: 404 Not Found ——很多配置看似生效,其实只是返回了 200 状态的“长得像 404 的页面”。


















