404页面必须被服务器真实触发、正确返回404状态码且语义清晰:文件名严格为404.html并置于根目录;Apache用ErrorDocument 404 /404.html,Nginx配error_page 404 /404.html并排除fallback覆盖;HTML中需含“404”文字,禁用meta刷新与外部资源依赖。

404页面不是“放个文件就行”,它必须被服务器真实触发、正确返回、语义清晰——三者缺一不可。否则你写的页面根本不会被用户或搜索引擎看到。
404.html 文件名和位置写错
静态托管平台(GitHub Pages、Vercel、Netlify、Cloudflare Pages)只认 404.html 这一个名字,且必须放在项目根目录下。
- 写成
404.htm、error404.html、pages/404.html或404.HTML都无效 - Windows 记事本保存可能带 BOM,用
git ls-files | grep 404确认是否真提交了该文件 - Jekyll 用户需在
404.html开头加---\npermalink: /404.html\npublished: false\n---,否则会被当作普通页面渲染
服务器没返回真实 404 状态码
有 404.html 文件 ≠ 服务器返回了 404。常见错误是返回 200 OK 或 302 跳转,这会让搜索引擎当成普通页面收录,也破坏爬虫对死链的识别逻辑。
- 浏览器控制台 Network 标签页里看响应状态:应为
404 Not Found,不是200 OK - Apache:在
.htaccess中写ErrorDocument 404 /404.html,路径必须以/开头 - Nginx:在
server块中加error_page 404 /404.html;,并确保location = /404.html存在且未被其他rewrite规则覆盖 - SPA 应用(React/Vue)要特别注意:
try_files $uri $uri/ /index.html;这类 fallback 会吞掉所有 404,必须排除/404.html路径,例如try_files $uri $uri/ /index.html =404;
HTML 结构不满足可访问性与 SEO 要求
搜索引擎和屏幕阅读器靠结构识别页面意图,不是靠视觉样式。纯图片、SVG 文字或 JS 动态插入的 “404” 字样不可靠。
-
标签内必须包含明确文字 “404”,如404 Not Found
- 核心内容必须包裹在
中 - 建议加
,避免被搜索引擘误索引 - 不要用
替代文字,视障用户无法感知
表单或 JS 行为干扰了 404 流程
看似无关,但实际常出问题:比如在 404 页面里嵌入搜索框,但表单没设 type="submit",点击后触发表单默认提交,页面跳转或刷新,打断用户浏览路径。
- 所有
在表单内必须显式声明type="button"(非交互)或type="submit"(需确认后端支持) - 避免在 404 页面中执行依赖路由或 API 的 JS 初始化逻辑(如
fetch('/api/nav')),这些请求失败会污染控制台,且无意义 - 如果用了 JS 加载推荐内容,确保兜底逻辑:网络失败时仍显示静态文案,不留白
最容易被忽略的是 SPA fallback 和 Jekyll 元数据这两处——它们不会报错,也不会提示你配置错了,只是默默让 404.html 失效。上线前务必用 curl 或浏览器隐身模式直接访问一个不存在路径,看 Network 面板的状态码和响应体是否匹配预期。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











