404页面无效通常因服务器未返回真实404状态码,需用curl或Network面板确认响应头中Status为“404 Not Found”;若返回200,则配置失效,常见于SPA兜底页、Nginx/Apache配置遗漏internal或ErrorDocument指令错误、静态托管平台(如GitHub Pages、Vercel、Netlify)未遵循命名与路径规范,且404.html须纯HTML、禁用JS跳转、使用绝对路径资源。

404页面没效果,几乎可以确定是服务器没返回真正的 404 Not Found 状态码——你看到的只是个普通 HTML 文件被当成 200 页面加载了。
用 curl 或 Network 面板确认是否真返回 404 状态码
别信页面内容,只看响应头。这是所有排查的前提。
- 在终端执行
curl -I http://localhost/nonexistent-path,必须看到HTTP/1.1 404 Not Found;如果返回200 OK,说明配置完全没生效 - 浏览器打开 DevTools → Network → 刷新一个不存在的路径(如
/xyz),点开该请求,在 Response Headers 里找Status: 404 Not Found - 常见误判:单页应用(SPA)的兜底路由页(比如 React Router 的
errorElement)永远是 200,它不是服务器级 404
Nginx / Apache 配置必须带 internal 且位置正确
只写 error_page 404 /404.html 是不够的,漏掉关键限制会导致外部可直连 /404.html 并返回 200。
- Nginx 正确写法:
error_page 404 /404.html; location = /404.html { internal; }漏掉internal,用户访问/404.html就会得到 200 响应 - Apache 正确写法:
ErrorDocument 404 /404.html,需确保mod_alias已启用,且该指令放在虚拟主机或.htaccess中(后者要求AllowOverride All) - 配置改完必须重启服务:Nginx 用
nginx -s reload,Apache 用apachectl restart
GitHub Pages / Vercel / Netlify 各有硬性规则
这些平台不跑完整 Web 服务器,自定义 404 不是“放个文件就行”,而是严格按命名和位置触发。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- GitHub Pages:文件名必须是
404.html,且**只能放在仓库根目录**;/docs/404.html、/pages/404.html全无效 - Vercel:默认支持,但若项目含
vercel.json,必须显式配"errorPages": {"404": "/404.html"};仅靠rewrites无法改变状态码 - Netlify:需在根目录放
_redirects文件,内容为/* /404.html 404;或用netlify.toml配[[redirects]] from = "/*" to = "/404.html" status = 404
404.html 文件本身不能依赖 JS 或相对路径
用户可能禁用 JS、网络中断、或页面加载失败——此时只有原生 HTML 能保证核心信息可见。
- 主标题必须是
,不能是图片或 SVG 文本(除非加404
aria-label="404") - 不要用
window.location.href = "/"或跳转,这会让响应变成 200 - CSS 和按钮链接必须用绝对路径:
,而不是css/main.css - 展示当前路径可用:
<script>document.write(location.pathname)</script>,帮助用户确认拼写错误
最容易被忽略的一点:本地双击打开 file:/// 路径永远不会触发 404——那只是浏览器读文件。真验证,必须走 http://localhost 或线上地址,并始终以响应头为准。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










