nginx静态网站404页面必须返回真实404状态码，关键在配置error_page 404 /404.html并配location = /404.html { internal; }，确保路径存在、可读且禁止直接访问，否则返回200导致seo失效。
静态网站的404页面必须返回 404 Not Found 状态码，否则就是无效的——搜索引擎会当正常页收录，缓存策略也会错乱。统一管理的关键不是“怎么写页面”，而是“怎么让所有项目都正确触发并返回真实404”。
Nginx error_page 配置必须带 internal 且路径严格匹配
很多人写 error_page 404 /404.html; 就以为完事了，结果 curl -I 看到的是 HTTP/1.1 200 OK。根本原因是 Nginx 把 /404.html 当作普通静态文件返回，不继承状态码。
- 必须加
location = /404.html { internal; }：阻止用户直接访问/404.html，同时让error_page触发时自动带上 404 状态 - 路径不能写成
error_page 404 = /404.html（等号是常见笔误，会导致语法错误或静默失效） - 如果 root 是
/data/src/admin-client，那/404.html必须真实存在于该目录下，或通过符号链接指向统一源 - 测试命令固定为：
curl -I https://yoursite.com/nonexistent-path，只看响应头，不看页面内容
多个前端项目共用一套 404.html 的符号链接方案
当你有 admin-client、user-client、api-docs-client 等十几个静态 SPA 项目时，复制粘贴 404.html 会失控。符号链接是最轻量、可批量维护的解法。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 统一源建议放至
/data/html/error/404.html（确保www-data用户可读） - 批量生成链接：
ln -sf /data/html/error/404.html /data/src/*/404.html - 验证是否有效：
ls -l /data/src/*/404.html，确认箭头指向真实路径，且无broken提示 - 禁止把源文件放在
/etc、/root或用户家目录——Nginx worker 进程无权读取
GitHub Pages / Netlify 等静态托管平台的特殊限制
它们不支持传统服务器的 error_page 指令，404 行为由平台规则硬编码决定，无法靠 Nginx 配置干预。
- GitHub Pages：只认根目录下的
404.html文件，命名和位置都不能改；它会自动返回 404 状态码——但仅限于真正未命中路径；若你用前端路由（如 React Router），/xxx被index.html捕获，那就永远返回 200，此时404.html不生效 - Netlify：需显式配置重定向规则，例如在
_redirects中写：/* /404.html 404；或在netlify.toml中声明[[redirects]] from = "/*" to = "/404.html" status = 404 - Vercel：默认不启用自定义 404，必须在
vercel.json中设置"cleanUrls": true并确保404.html在根目录；动态路由场景下，仍需配合rewrites显式 fallback
HTML 页面本身要避免破坏语义和可访问性
即使状态码正确，页面结构不合理也会让 SEO 和残障用户失效。
-
<title></title>必须含 “404” 字样，例如<title>404 - 页面未找到</title>，否则搜索结果点击进来可能被当成首页 - 主内容区必须用
<main></main>或<div role="main"> 包裹，让屏幕阅读器跳过导航直读错误信息<li>所有链接用绝对路径（如 <code>/、/products），避免相对路径在深层 URL 下失效 - 禁用
<meta http-equiv="refresh">自动跳转——它强制返回 200，且对辅助技术不友好
最常被忽略的一点：本地双击打开 index.html 根本测不出 404 效果，因为没走 HTTP 协议栈。一切验证必须基于真实请求，哪怕只是 python3 -m http.server 8000 起个本地服务。状态码不对，其他都白搭。
