404.html 文件需配合服务器配置才能生效:Apache用ErrorDocument 404 /404.html并确保文件≥512字节;Nginx需error_page 404 /404.html加internal保护;静态平台要求严格命名与位置;资源须用绝对路径。

直接放一个 404.html 文件到网站根目录,不配服务器,99% 的情况它根本不会生效——浏览器看到的是你的页面,但 HTTP 状态码仍是 200 OK,搜索引擎当它是正常页,不是错误页。
Apache:必须用 ErrorDocument 指令,且路径以 / 开头
只改文件名或位置没用,关键在指令写法和生效范围:
-
ErrorDocument 404 /404.html是唯一正确写法;ErrorDocument 404 404.html(缺斜杠)会被当成相对路径,多数情况失效 - 必须放在站点配置文件(如
/etc/apache2/sites-enabled/000-default.conf)或.htaccess中;后者需确保AllowOverride All已启用 - 文件大小不能小于 512 字节,否则 IE 及部分旧版浏览器会强制显示默认提示页(哪怕你写了
404.html) - 验证方式:终端执行
curl -I https://yoursite.com/nonexistent,响应头第一行必须是HTTP/1.1 404 Not Found
Nginx:error_page 必须配合 internal 保护
漏掉 internal 会导致用户能直接访问 /404.html,此时状态码变成 200,彻底破坏语义:
- 在
server块里加两行:error_page 404 /404.html;location = /404.html { internal; } - 不要写成
error_page 404 /error/404.html—— 路径必须与文件系统位置一致,且不能有重定向逻辑 - 如果用了
try_files(比如 Vue/React history 模式),error_page要放在location /块内,否则可能被覆盖 - 改完必须
sudo nginx -t && sudo systemctl reload nginx,只改文件不 reload 不生效
静态托管平台(GitHub Pages / Vercel / Netlify):命名和位置不能错半点
这些平台不跑完整 Web 服务器,自定义 404 是硬编码识别的,容错率极低:
立即学习“前端免费学习笔记(深入)”;
- GitHub Pages:文件名必须是
404.html(全小写),且必须放在仓库**根目录**;/docs/404.html、/error/404.html都无效 - Vercel / Netlify:支持
404.html或404.htm,但不能是404.ejs、404.vue等模板文件;若项目含src/pages/404.vue,那是框架级处理,和静态 404 无关 - Jekyll 用户注意:在
_config.yml中加exclude: ["404.html"],否则 Jekyll 可能把它渲染成/404/index.html,路径就错了 - 本地测试无效:双击打开
file:///或用python -m http.server都无法触发真实 404,必须部署后实测
最容易被忽略的一点:所有资源路径(CSS、JS、图片)在 404.html 里必须用绝对路径(如 /css/style.css),否则在 /a/b/c 这类深层路径下触发 404 时,浏览器会按当前 URL 拼接资源地址,导致样式和脚本全部 404。这不是服务器配置问题,是 HTML 写法问题。



















