404.html必须严格置于网站根目录且命名不可更改,所有主流平台强制要求此路径;Nginx/Apache配置需以/开头并避免被重写规则覆盖;资源链接须用根相对路径,CSS内联、禁用base标签,HTML跳转优先于JS。

404.html 文件必须放在网站根目录,命名不能改
服务器只认 404.html 这个确切文件名,且必须和 index.html 在同一级目录下。写成 error-404.html、404-page.html 或放在 /pages/404.html 都不会被识别。GitHub Pages、Netlify、Vercel 等平台全部强制要求这个路径和命名,没有例外。
常见错误包括:
- 本地双击打开
404.html—— file:// 协议不产生 HTTP 状态码,完全无法验证 - 把
index.html改名为404.html—— 它只是普通页面,服务器不会把它当错误响应体返回 - 用构建工具(如 Vite)输出到
dist/404.html后,没确认该文件是否真在部署后的根路径下
Nginx 和 Apache 的 error_page 路径必须以 / 开头
error_page 404 /404.html; 中的 /404.html 是从网站根目录开始找的路径,不是相对当前配置文件位置。如果漏掉开头的 /,Nginx 会按配置文件所在路径去拼,大概率 404 页面自己也返回 404。
Apache 同理:ErrorDocument 404 /404.html 必须带前导斜杠,且不能加引号、分号或换行符干扰解析。如果用了 WordPress 的伪静态规则,这条语句必须放在所有重写规则之后,否则会被覆盖。
还要额外注意:
- Nginx 中若已有
location / { try_files $uri $uri/ /index.html; },它会把所有未命中文件 fallback 到index.html,导致真正的 404 被吞成 200;必须单独配location = /404.html { internal; }来保护它 - 宝塔面板点「启用自定义错误页」只是图形化操作,底层仍依赖这行指令是否生效,需手动检查配置文件
跳转链接必须用绝对路径,别信相对路径
用户访问 /blog/post/abc 时触发 404,浏览器当前 URL 就是那个地址。此时页面里写 @#@#@#@#@#@#@#@#@#@0 回首页
@#@#@#@#@#@#@#@#@#@1 指向联系页@#@#@#@#@#@#@#@#@#@2 图片等资源也得这样写,避免深层 URL 下加载失败禁用 —— 它会劫持所有相对路径,一旦值和实际部署路径不一致(比如开发时设为 /dev/,上线却是根目录),整个导航就全崩。
跳转逻辑不能依赖 JavaScript,但可增强体验
“回到首页”按钮必须是纯 HTML 链接:@#@#@#@#@#@#@#@#@#@3。不要用 ,JS 禁用或执行失败时,用户就卡在错误页了。
如果想加动画或延迟跳转,得满足两个前提:
- 动画结束后再执行
location.replace("/"),且必须包裹在DOMContentLoaded里,避免 DOM 未就绪 - 页面上必须保留可见文字,如
和明确文案,不能只显示“正在跳转…”404
- 加
,防止搜索引擎误收录
最易忽略的一点:所有 CSS 必须内联在 里,图片用 data URL 或根路径,因为 /404.html 可能是在其他资源(比如 /css/main.css)也 404 的上下文中返回的——这时候再请求外部样式,页面就只剩白底黑字了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











