404页面必须由服务器真实返回404状态码才生效,file://协议下双击打开仅为200 OK;需用HTTP服务(如npx serve)验证,静态平台要求根目录放小写404.html,Nginx/Apache须配置error_page或ErrorDocument并确保响应头为404。

404页面不是“写完HTML就能用”,它必须被服务器真实返回 404 Not Found 状态码,否则搜索引擎当普通页收录、用户无法识别死链、所有设计都白费。
为什么本地双击404.html永远不生效
file:// 协议没有 HTTP 状态码概念,浏览器打开 404.html 时返回的是 200 OK —— 这只是一个普通文件。真正的 404 页面需要服务端在找不到资源时,主动返回状态码 404 并把你的 HTML 当作响应体发送。
- 验证方式必须走 HTTP:用
npx serve -s启服务后访问http://localhost:5000/nonexistent-path,再看 Network 面板的 Status 是否为404 - 命令行更可靠:
curl -I https://yoursite.com/xxx,第一行必须是HTTP/1.1 404 Not Found - 常见错误现象:页面显示“404”文字,但 Network 里状态码是
200;或 Google Search Console 把它标为“可访问页面”
静态托管平台(GitHub Pages / Vercel / Netlify)怎么配
它们默认只认一个确切路径和文件名:/404.html,且必须放在项目根目录(跟 index.html 同级),全小写、无空格、无 BOM。
- GitHub Pages:提交
404.html到仓库根目录即可;Jekyll 用户需在文件开头加---permalink: /404.htmlpublished: false--- - Netlify:在项目根目录建
_redirects文件,写一行/* /404.html 404;或在netlify.toml中配[[redirects]] from = "/*" to = "/404.html" status = 404 - 常见失效原因:文件名写成
404.htm、error-404.html、pages/404.html,或 Windows 记事本保存带 BOM,Git 不识别
自建服务器(Nginx / Apache)关键配置项
配置目标只有一个:当请求任意无效路径时,返回 404 状态码 + 你写的 404.html 内容,不能跳转、不能 fallback、不能覆盖。
立即学习“前端免费学习笔记(深入)”;
- Nginx:在
server块中加error_page 404 /404.html;,并确保有location = /404.html { }且未被rewrite规则拦截 - Apache:在
.htaccess或虚拟主机配置中写ErrorDocument 404 /404.html,路径必须以/开头 - SPA 应用特别注意:Nginx 的
try_files $uri $uri/ /index.html;会吞掉所有 404,必须排除404.html路径,例如try_files $uri $uri/ @fallback;+location @fallback { try_files $uri $uri/ /index.html; }
HTML结构里哪些东西不能省
这不是普通网页,而是服务端注入的错误响应体,语义和可访问性是硬要求,不是“可有可无”。
-
<title></title>必须含 “404”,如<title>404 - 页面未找到</title>,否则搜索结果点进来像进了首页 -
<h1></h1>必须直写 “404 Not Found” 或 “页面未找到(404)”,不能是图片、SVG 文本或 JS 渲染内容 - 主内容必须包裹在
<main></main>或加role="main",让屏幕阅读器跳过导航直接读错误信息 - 加
<meta name="robots" content="noindex">,防止被搜索引擎误收录 - “返回首页”链接必须是
<a href="/">← 返回首页</a>,禁用<button onclick="location.href='/'"></button>和<meta http-equiv="refresh">
最容易被忽略的点:状态码本身比页面多炫酷都重要;所有外部资源(CSS/JS/图片)必须内联或用根相对路径,否则 404 页面可能白屏——因为服务器连自己都找不到那些文件。



















