直接用404.html放在网站根目录即可,绝大多数静态托管服务会自动识别并返回该页面;文件名必须严格为404.html(大小写敏感、不可用.htm),且所有资源链接须用绝对路径(如/style.css),同时提供首页导航等补救入口,部署后需通过访问不存在路径验证真实404响应。

直接用 404.html 放在网站根目录就行
绝大多数静态托管服务(如 GitHub Pages、Vercel、Netlify、Nginx 默认配置)会自动识别根目录下的 404.html 文件,并在所有未匹配路由时返回它,**不需要任何配置、不依赖服务器端逻辑**。
注意:文件名必须严格是 404.html,大小写敏感;不能叫 not-found.html 或 404.htm(.htm 不被普遍支持)。
- GitHub Pages 要求文件编码为 UTF-8 无 BOM,否则可能乱码
- Netlify 和 Vercel 还支持
_redirects或vercel.json自定义重定向规则,但纯静态场景下没必要 - Nginx 默认启用
error_page 404 /404.html,但需确认 root 路径指向正确,且404.html在该 root 下
404.html 里别用相对路径的 CSS/JS
用户访问一个不存在的 URL(比如 /blog/post/2025/missing),浏览器会尝试从该路径上下文加载资源。如果你写 ,浏览器实际请求的是 /blog/post/2025/style.css —— 404 页面自己又触发一次 404,导致样式丢失、脚本不执行。
- 所有资源链接必须用绝对路径:
/style.css、/js/main.js、/images/logo.png - 图片、字体等静态资源也同理;如果用内联 SVG,确保没有引用外部
xlink:href - 避免在
404.html中使用,它会影响所有相对链接,反而更难控制
内容要带明确导航,别只写“页面不见了”
纯文字提示(如 “404 Not Found”)对用户毫无帮助,尤其当用户是从搜索引擎点击进来的。真正的 404 页面是**补救入口**,不是报错终点。
- 至少提供一个回到首页的链接:
@#@#@#@#@#@#@#@#@#@0 - 可加搜索框(如果网站有前端搜索):
- 避免 JavaScript 渲染导航:用户可能正处在路由错误状态,JS 加载失败时整个页面就只剩白屏
- 不要自动跳转(
meta http-equiv="refresh"):干扰用户操作,也不利于 SEO
检查是否真生效,别被本地预览骗了
用 file:// 协议双击打开 404.html,或用 python3 -m http.server 启动简易服务器,都**无法模拟真实 404 行为**——它们只会显示这个 HTML 文件本身,不会触发服务器级错误响应。
- 真正验证方式:部署后,手动访问一个明显不存在的路径(如
/this-path-does-not-exist-abc123),看返回状态码是不是404,且页面内容是你写的404.html - 用浏览器开发者工具的 Network 面板确认响应状态码和 Content-Type(应为
text/html) - 某些托管平台(如 GitHub Pages)对自定义 404 有缓存,首次部署后可能需要几分钟才生效
最容易被忽略的一点:404 页面本身不能有内部 404。只要有一个 /css/main.css 返回 404,整个样式就挂了——而你根本看不到控制台报错,因为那是另一个请求。先确保所有 /xxx 开头的资源路径在根目录下真实存在,再测 404。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











