静态HTML站点的404页面必须同时满足三个硬性条件:文件名严格为404.html、置于网站根目录(与index.html同级)、服务器返回真实HTTP 404 Not Found状态码;任一缺失都会导致平台默认页生效而非自定义页。

静态站点的404页面不是“加个HTML就行”,而是必须满足三个硬性条件:文件名严格为 404.html、放在网站根目录、服务器返回真实 404 Not Found 状态码——缺一不可。
为什么放了404.html还是显示平台默认页?
最常见原因是文件没放对位置或命名出错。GitHub Pages、Netlify、Vercel、Cloudflare Pages 这些平台只识别 404.html 这个确切文件名,且必须位于仓库根目录(和 index.html 同级)。写成 404.htm、error.html、pages/404.html 或 404.HTML 全部无效。
- 用
git ls-files | grep 404检查 Git 是否真提交了该文件(Windows 记事本可能悄悄加 BOM) - Jekyll 用户需在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被当作普通页面渲染 - 宝塔面板里勾选“启用自定义错误页”只是图形化操作,底层仍依赖 Nginx 的
error_page 404 /404.html指令是否生效
Nginx 配置 error_page 时容易漏的关键点
error_page 404 /404.html 这行本身不保证能访问到你的文件——它只是告诉 Nginx “遇到 404 就去加载这个路径”,但若没有显式允许该路径被直接读取,Nginx 可能因 try_files 规则拦截而返回 200 状态的 index.html。
- 必须在
server块中添加location = /404.html { }(空配置即可),否则/404.html请求会被location / { try_files $uri $uri/ /index.html; }拦截 -
error_page后面的路径必须以/开头(如/404.html),表示相对于网站根目录;写成404.html或./404.html会失效 - 如果用了 SPA 路由(React/Vue history 模式),要确保
try_files规则排除/404.html,例如:try_files $uri $uri/ @fallback;,再单独配location @fallback { ... },避免把真实 404 吞成 200
纯 HTML + 内联 CSS 是最稳的写法
很多 CDN(如 Cloudflare 免费版)、GitHub Pages 或 Nginx 默认配置会拦截并替换你写的 HTML,导致 JS 不执行、外部 CSS 不加载。所以优先保障页面在无网络、无 JS、无外部资源的情况下也能正确渲染。
- 所有样式写进
标签,别引用main.css或 CDN 字体 - 不要用
fetch()、history.back()、动态插入文本等依赖 JS 的逻辑 - 如果加自动跳转,用
setTimeout(() => location.href = '/', 10000),设 10 秒以上兜底,避免用户刚打开就被跳走 -
标签里必须包含 “404” 文字(如),这是 SEO 和屏幕阅读器识别错误页的唯一可靠方式404 Not Found
最容易被忽略的是状态码本身——哪怕页面长得再像 404,只要 Network 面板里看到状态码是 200 OK,那就不是真正的 404 页面,搜索引擎也不会当错误页处理。每次改完配置,务必用一个明显不存在的路径(如 /asdf123)测试,并盯住响应头里的 Status 和 Server 字段。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











