是,绝大多数静态托管平台(如GitHub Pages、Vercel、Netlify)及Apache/Nginx默认仅识别根目录下严格小写的404.html;改名需手动配置服务器指令,增加出错风险。

404页面必须叫 404.html 吗?
不是必须,但绝大多数静态托管平台(如 GitHub Pages、Vercel、Netlify)只认 404.html 这个文件名。Apache 和 Nginx 默认也只响应这个路径;如果改名(比如 not-found.html),就得手动配置服务器的 ErrorDocument 404 或 error_page 指令——对纯前端部署来说,多一步就多一个出错点。
实操建议:
- 直接新建
404.html,放在项目根目录(不是/src或/public子目录下,除非你明确知道构建工具如何映射) - 若用 Hugo/Jekyll 等 SSG,确认其是否自动生成
404.html;有些会默认忽略,需在配置中显式启用404: true类选项 - 本地测试时,别用双击打开
file://协议——浏览器会禁用相对路径和部分 CSS/JS;务必起一个本地服务,比如npx serve或python3 -m http.server
HTML 结构里哪些元素容易被忽略?
一个可用的开源 404 页面,核心不是动画或插图,而是语义正确 + 导航可靠。很多开源模板套了炫酷 CSS,却漏掉关键可访问性与基础功能。
必须包含的三项:
-
文本要含 “404” 字样(搜索引擎和屏幕阅读器依赖它,不能只靠 H1) - 至少一个指向首页的绝对路径链接:
@#@#@#@#@#@#@#@#@#@0(避免,子路径下会 404 嵌套) - 显式声明
,防止搜索引擎收录该页
可选但推荐:,告诉爬虫这是首页的替代入口,降低重复内容风险。
用开源模板时,href 和 src 路径为什么总 404?
根本原因是开源 HTML 模板常假设自己部署在域名根路径(https://example.com/),而你实际可能部署在子路径(https://example.com/my-app/)。所有相对路径都会错位。
解决方式取决于部署环境:
- GitHub Pages 用户页(
username.github.io):用根相对路径,即href="/css/style.css",而非href="css/style.css" - GitHub Pages 项目页(
username.github.io/repo):必须用相对路径或构建时注入BASE_URL;推荐改用放在顶部,之后所有相对 URL 自动补前缀 - Vercel/Netlify:可在
vercel.json或_redirects中配重写规则,但更稳妥的是构建前用脚本替换路径,或直接用<script>document.currentScript.src</script>动态推导基址
上线后 404 页面不生效?先查这三件事
常见现象是:输入错误 URL 后返回的是平台默认 404(比如 GitHub 的“Page not found”白页),而不是你的 404.html。原因往往很具体:
- 文件名拼错:检查是否为
404.html(不是404.htm、404.HTML或带空格) - 托管平台限制:GitHub Pages 项目页仅在
gh-pages分支且build后才识别404.html;若用main分支 +/docs目录部署,则不会触发自定义 404 - 缓存干扰:CDN 或浏览器缓存了旧的 404 响应(状态码仍是 404,但内容没更新);用
curl -I https://yoursite.com/nonexistent查看HTTP/2 404响应头,并确认content-length与你本地404.html大小一致
最隐蔽的坑:某些 CI/CD 流程(如 GitHub Actions 的 actions/jekyll-build-pages)会覆盖或忽略 404.html —— 需确认构建产物中该文件真实存在且未被清理规则误删。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











