必须将严格命名为404.html的文件置于网站根目录,并配置服务器在404状态时返回该文件及正确状态码;否则SEO与可访问性失效。

直接放一个 404.html 到网站根目录,再让服务器在真实 404 状态下返回它——否则用户看到的只是默认页,状态码大概率是 200 或 302,SEO 和可访问性全失效。
404.html 文件必须放在根目录且命名严格为小写
文件名不能是 404.htm、error404.html 或 404.HTML;路径不能是 /pages/404.html 或 ./404.html。GitHub Pages、Vercel、Netlify 只识别 /404.html 这个确切路径(与 index.html 同级)。Jekyll 用户还需在 404.html 开头加 permalink: /404.html 和 published: false,否则会被渲染成普通页面。
Nginx 和 Apache 的配置关键点
光有文件没用,服务器必须主动用它响应 404 状态:
- Nginx:在
server块里写error_page 404 /404.html;,并确保存在location = /404.html { }规则,否则可能被try_files $uri $uri/ /index.html;拦截,导致返回 200 状态码 - Apache:在
.htaccess或虚拟主机配置中加ErrorDocument 404 /404.html,注意开头必须有斜杠,不能写成404.html或./404.html,且该行要放在伪静态规则之后,避免被覆盖 - 宝塔面板:进「网站设置 → 配置文件 → 自定义错误页」,勾选启用,填
404.html(若文件在根目录),保存后重载服务
404.html 页面里最容易踩的三个坑
很多“自定义页”实际破坏了 HTTP 语义,搜索引擎和屏幕阅读器根本认不出这是错误页:
- 别用
或 JS 跳转(如window.location.href = '/')——这会让响应状态码变成 200,Google 会把失效链接的权重全算到首页上 -
和必须含 “404” 或 “Not Found”,例如;否则辅助技术和爬虫无法识别上下文404 - 页面未找到 - 所有资源路径(CSS、图片、字体)必须用绝对路径或根相对路径(如
/css/style.css),不能用相对路径(如./css/style.css),因为请求 URL 可能是/blog/post/xxx,相对路径会错配到不存在的位置
测试是否真正生效的唯一方式
本地双击打开 404.html 完全无效——file:// 协议没有 HTTP 状态码概念。必须走真实 HTTP 请求:
- 用
npx serve或python3 -m http.server 8000启服务,然后访问http://localhost:8000/asdf123456 - 打开浏览器开发者工具 → Network 标签 → 找到该请求 → 看 Response Headers 里的
Status: 404 Not Found - 命令行更准:
curl -I https://yoursite.com/nonexistent,第一行必须是HTTP/1.1 404 Not Found
最常被忽略的是:即使配置对了,Nginx 的 location /404.html 规则缺失、Jekyll 的 front matter 没禁用、或是 CSS 外链加载失败导致页面空白——这些都会让“自定义”形同虚设。状态码不对,其他全是白忙。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











