必须同时返回404状态码且页面可正常读取:Nginx用error_page 404 /404.html,Apache用ErrorDocument 404 /404.html,Netlify/Vercel需确保构建后404.html存在;避免fallback兜底不改状态码、相对路径错误、base标签干扰、JS跳转及前后端路由冲突。

自建站的 404 页面不是“随便放个提示页就行”,而是必须同时满足两个条件:服务器真实返回 404 状态码,且页面内容可被用户和爬虫正常读取。否则百度不认、用户困惑、SEO 反而受损。
怎么让服务器真返回 404 状态码而不是 200
很多人把 404.html 放进网站根目录,然后访问 /nonexistent-page 却看到页面内容——但 Network 面板里状态码是 200。这说明服务器根本没触发 404,只是前端路由或 Nginx/Apache 的 fallback 把请求兜底到了 index.html 或 404.html,但没改状态码。
- Nginx:必须用
error_page 404 /404.html;,且确保该路径下有真实文件;不能只靠try_files $uri $uri/ /index.html;来兜底,它不会改状态码 - Apache:在
.htaccess中写ErrorDocument 404 /404.html,并确认AllowOverride All已启用 - Netlify/Vercel:默认支持,但需在项目根目录放
404.html,且构建后该文件必须出现在发布目录中(比如_site/404.html) - 本地双击打开 HTML 文件(
file://协议)时,任何 404 配置都无效——浏览器根本不走 HTTP 协议,也就没有状态码概念
404.html 文件本身要避开哪些坑
即使服务器返回了 404 状态码,如果 404.html 内部引用了坏资源,或者结构不兼容,效果也会打折扣。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
<link rel="stylesheet" href="css/style.css">→ 改成绝对路径<link rel="stylesheet" href="/css/style.css">,否则在/a/b/c路径下会错误请求/a/b/css/style.css - 避免在
404.html中使用<base href="/subapp/">,除非你确定所有相对路径都按这个前缀解析,否则 JS/CSS/img 全挂 - 不要用 JavaScript 动态跳转回首页(如
setTimeout(() => location.href = "/", 3000)),搜索引擎可能无法识别意图,也影响可访问性 - 确保
<title></title>包含 “404” 或 “未找到” 字样,便于爬虫识别;正文第一行建议直接写<h1>页面未找到</h1>,语义清晰
前后端同域时特别容易踩的雷
如果你的前端静态资源和后端 API 共用一个域名(比如都部署在 https://example.com),而用户访问的是一个本该由前端接管的路由(如 /dashboard),但后端框架(Express/Spring Boot)恰好定义了同名接口,就可能返回 404 + application/json,导致浏览器渲染出空白或报错,而不是你的 404.html。
立即学习“前端免费学习笔记(深入)”;
- 打开 Network 面板,看 404 请求的
Response Headers中Content-Type是text/html还是application/json - 如果是后者,说明请求被后端拦截了,需调整后端路由顺序,或约定前端路由统一加前缀(如
/app/dashboard) - 检查后端日志,确认该路径是否真无 handler,还是 handler 主动返回了 404
- 临时可在后端加一条兜底路由:对所有非 API 路径(如不以
/api/开头),返回404.html并设置状态码为404
真正关键的点在于:404 页面不是前端单方面能控制的,它横跨服务器配置、文件路径、HTTP 协议层和爬虫识别逻辑。哪怕你写得再漂亮,只要 Nginx 没配 error_page,或者 Netlify 构建后 404.html 被误删,用户看到的就只是个空页或错误提示框。


















