必须通过HTTP服务(如npx serve -s)访问不存在路径,用Network面板或curl验证响应头为“HTTP/1.1 404 Not Found”,而非file://双击打开;GitHub Pages等平台要求根目录严格小写命名404.html,且页面需含语义化404、404、内联CSS(≤1KB)、无自动跳转。

404页面不是“写个提示就行”,它必须被服务器真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户无法识别死链、跳转逻辑失效——所有前端工作都白搭。
如何确认你的 404.html 被服务器真正调用
本地双击打开 404.html 永远是 200 OK,毫无验证价值。必须走 HTTP 协议测试:
- 用
npx serve -s启服务,访问http://localhost:5000/xyz123,打开 DevTools → Network → 查看该请求的Status是否为404 Not Found - 命令行更可靠:
curl -I https://yoursite.com/nonexistent,第一行必须是HTTP/1.1 404 Not Found - GitHub Pages、Vercel、Netlify 等静态托管只认根目录下严格小写的
404.html;写成404.htm、pages/404.html或404.HTML都不生效 - SPA 应用(如 React/Vue)常见陷阱:
try_files $uri $uri/ /index.html会把所有 404 吞掉返回200,需排除/404.html路径
HTML结构里哪些标签和文字不能省
和 必须直写 “404”,不能靠图片、SVG 或 JS 渲染——这是 SEO 和屏幕阅读器识别错误页的唯一依据:
-
必须含 “404”,例如404 - 页面未找到 -
是硬性要求,不能替换成404 Not Found

- 核心内容必须包裹在
内,或加role="main",让辅助技术跳过导航直接读错误信息 - 返回首页必须用
@#@#@#@#@#@#@#@#@#@0,禁用—— JS 关闭时按钮就失效
CSS为什么必须内联且不能超1KB
404 页面可能发生在任意子路径(比如 /blog/post/xxx),若引用外部 CSS,路径解析失败概率极高;更糟的是,加载失败会导致白屏:
- 所有样式必须写进
标签,禁用 - 字体栈用系统默认:
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif,不依赖 Web Font - 单位优先用
rem或em,避免px在高 DPI 屏上过小 - 对比度必须 ≥ 4.5:1,可用 webaim.org/contrastchecker 验证;深灰背景配浅灰文字(如
#333+#999)不合格 - 禁用
@import、背景图、动画帧(@keyframes可保留但慎用),它们会触发额外请求或兼容问题
为什么不要自动跳转(包括 JS 和 meta refresh)
Google 明确将无停留、无提示的自动跳转视为“软 404”,会降权甚至拒收。用户也需要 2–3 秒确认自己进了错误页:
- 禁用
—— 它让响应状态变成200 - 禁用
setTimeout(() => location.href = '/', 2000),除非你同时提供清晰文案和手动入口 - 如果真要加跳转动画(如“跳入首页”),必须确保:动画结束后才执行
location.replace("/"),且和说明文字全程可见 - 搜索框用标准
,input 带name="q",不依赖 JS 提交
最容易被忽略的点:状态码由服务器决定,前端改不了;但前端能决定用户是否看清它是 404 —— 所以 文字、 内容、语义化结构,一个都不能妥协。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











