404.html必须放在网站根目录且严格命名为小写,GitHub Pages、Netlify、Vercel等平台仅识别该路径和名称;服务器须显式配置返回真实HTTP 404状态码,不可依赖跳转或本地双击测试。

404.html 文件必须放在根目录且命名严格为小写
不是随便放个 HTML 文件就能叫 404 页面——服务器只认 404.html 这个确切文件名,且必须和 index.html 在同一级目录(即网站根目录)。GitHub Pages、Netlify、Vercel 等平台都只扫描这个路径;改名成 error-404.html 或放在 /pages/404.html 下,统统不生效。
常见错误现象:
上传了页面但访问不存在路径时仍显示默认 Nginx/Apache 错误页,或跳回首页(状态码是 200)。
- 确认文件名是
404.html,全小写,无空格、无 BOM、无隐藏扩展名(比如404.html.txt) - 用命令行检查:进入项目根目录,执行
ls -l 404.html,确保它真实存在 - 若用 Jekyll 构建,需在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被渲染成普通页面
服务器必须显式返回 404 状态码,不能靠跳转
用户看到“404”字样 ≠ 真是 404 页面。浏览器和搜索引擎只看响应头里的 Status: 404 Not Found。如果页面靠 或 JS 跳转实现,实际状态码仍是 200,SEO 会把死链当正常页收录,爬虫也无法识别异常。
验证方式必须走 HTTP 协议:
本地测试用 npx serve 启服务,访问 http://localhost:5000/asdf123,打开 DevTools → Network → 查看该请求的 Response Headers;线上用 curl -I https://yoursite.com/xxx,第一行必须是 HTTP/1.1 404 Not Found。
- Apache:在
.htaccess中写ErrorDocument 404 /404.html(注意开头斜杠,不能换行或加分号) - Nginx:在
server块中加error_page 404 /404.html;,并确保有location = /404.html { }允许直接访问,否则会被try_files拦截返回 200 - Express(Node.js):路由末尾加
res.status(404).sendFile(path.join(__dirname, '404.html')),别漏status(404)
HTML 结构要精简,禁用外部资源与 JS 依赖
404 页面本身可能出现在资源加载失败的上下文中(比如 /assets/main.css 404),此时再请求外部 CSS、JS 或图片,只会触发更多失败请求,导致白屏或样式崩坏。
所有样式必须内联进 ,字体用系统栈,图片优先用 SVG 内联或 Data URI; 和 必须含 “404” 字样,主内容区用 包裹,加 防止被搜索引擎误收录。
-
示例:404 - 页面未找到 -
示例:,不可用图片替代页面未找到(404)
- 按钮全部用
@#@#@#@#@#@#@#@#@#@0,不用,禁用 JS 时仍可点击 - 避免
document.referrer直接赋值给href:先判断是否同域且非空,否则设为#并加aria-disabled="true"
本地双击打开永远测不出效果
用文件管理器双击 404.html,浏览器走的是 file:// 协议,压根没有 HTTP 状态码概念。此时无论你怎么写 res.status(404) 或配置 Nginx,都毫无意义。
唯一有效测试方式是启动一个最小 HTTP 服务,模拟真实请求流程。这也是最容易被忽略的一环——很多人反复改 HTML 却不验证状态码,以为是页面写错了,其实是根本没跑在 HTTP 环境里。
- 推荐命令:
npx serve(自动监听 5000 端口)、python3 -m http.server 8000、或 VS Code 的 Live Server 插件 - 测试路径必须是明显不存在的,如
/nonexistent-path,不能是/404.html自身(那是个 200 请求) - Network 面板里找那个
nonexistent-path请求,点开看 Headers → Response Headers → Status 是否为404 Not Found
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











