404页面必须由服务器返回真实HTTP 404状态码,而非仅放置404.html文件;需在Nginx中配置error_page 404 /404.html、Apache中配置ErrorDocument 404 /404.html,并确保HTML内联样式、禁用JS依赖、路径使用根相对地址,最后用curl -I验证响应头为404 Not Found。

404页面不是随便放个HTML就行
直接把写好的 404.html 丢进网站根目录,浏览器访问不存在的路径时大概率还是返回服务器默认错误页——因为多数 Web 服务器(如 Nginx、Apache)默认不识别这个文件名,也不会自动用它响应 404 状态码。
Nginx 里必须显式配置 error_page 404
光有 HTML 文件没用,Nginx 不会主动找 404.html。你得在 server 块里加一行明确指令:
error_page 404 /404.html;
注意几点:
-
/404.html是相对于网站 root 的路径,不是文件系统绝对路径 - 该文件必须能被静态资源规则匹配(比如 location ~ \.html$ {} 要放行)
- 如果用了 rewrite 或 proxy_pass,要确保 404 响应没被上游覆盖掉
- 别写成
error_page 404 = /404.html——带=会强制返回 200 状态码,SEO 和调试都会出问题
Apache 需要 .htaccess 或主配置启用 ErrorDocument
Apache 默认不读取 404.html,得靠 ErrorDocument 指令绑定:
ErrorDocument 404 /404.html
常见陷阱:
- 放在
.htaccess里时,AllowOverride必须包含FileInfo,否则无效 - 路径以
/开头表示站点根目录;不加斜杠(如404.html)是相对当前目录,容易 404 嵌套 - 如果启用了 mod_rewrite,某些重写规则可能拦截 404 请求,导致你的页面根本不会触发
HTML 本身要避免引入外部失败资源
现成 HTML 很可能引用了 CDN 上的 CSS/JS,或相对路径图片。一旦这些资源加载失败,404 页面自己就变成白屏或错位:
- 把所有 CSS 内联进
,JS 尽量内联或用defer+ 本地路径 - 图片用 data URL 或放在同目录下,确保
./logo.png这类相对路径在任何 URL 下都有效 - 别依赖 JavaScript 来跳转回首页——禁用 JS 时用户就卡死了,纯 HTML 的
@#@#@#@#@#@#@#@#@#@0才可靠 - 检查 HTTP 响应头:服务器必须返回
404 Not Found状态码,而不是200 OK。用 curl -I 测试确认
最常被忽略的是状态码本身——页面再好看,返回 200 就不是 404 页面,只是个普通 HTML 文件。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











