部署后HTML页面返回404，根本原因在于服务器未将文件识别为可访问资源：需严格核对文件路径与URL是否一致（含大小写、扩展名）、验证Nginx/Apache的fallback配置（如try_files或RewriteRule）、遵守GitHub Pages等平台的404文件命名与位置规则，并确保通过HTTP服务（而非file://）测试。
部署后 HTML 页面返回 404，基本可以断定：文件路径没错，但服务器没把它当“可访问资源”——不是代码问题，是服务配置或部署结构没对上。
检查文件是否真在 Web 根目录下
很多情况下，你确认“文件放对了”，其实是错觉。关键看两点：一是文件系统路径是否匹配 URL 路径，二是大小写和扩展名是否完全一致。
- 比如访问
http://example.com/about.html，那文件必须真实存在于服务器的 Web 根目录（如 Nginx 的/usr/share/nginx/html）下，且名字就是about.html，不能是About.html或about.htm - Windows 上容易被隐藏扩展名误导：
about.html.txt看起来像about.html，但服务器找不到后者 - Linux/macOS 区分大小写，
/Pages/index.html和/pages/index.html是两个不同路径，URL 写错一个字母就 404 - 用
curl -I http://localhost/about.html直接测响应头，确认是不是真返回HTTP/1.1 404 Not Found，而不是 200 或 301
Nginx/Apache 是否配置了 fallback 或重写规则
单页应用（SPA）部署后刷新页面 404，90% 是因为服务器没把所有请求兜底到 index.html。静态服务器默认只按路径找文件，而 SPA 的路由（如 /user/profile）根本没对应物理文件。
- Nginx 正确写法：
location / { try_files $uri $uri/ /index.html; }—— 注意不是/index.htm，也不是漏掉$uri/ - Apache 需启用
mod_rewrite，并在.htaccess或虚拟主机中写：RewriteRule ^(.*)$ /index.html [L]，且确保RewriteCond %{REQUEST_FILENAME} !-f和!-d已加 - 如果用了子路径部署（如
https://user.github.io/myapp/），Nginx 的root必须指向/myapp所在目录，不能只配/；否则try_files查找范围错误
GitHub Pages、Vercel 等托管平台的 404 特殊规则
这类平台不跑完整 Web 服务器，自定义 404 不是“放个文件就行”，必须严格遵循命名与位置约定，否则永远返回默认 404 页面。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
立即学习“前端免费学习笔记（深入）”；
- GitHub Pages：必须叫
404.html，且放在仓库**根目录**（不是/docs/404.html，也不是/src/404.html）；提交后需等 1–2 分钟生效 - Vercel：默认支持 SPA fallback，但若项目含
vercel.json，需显式配置：{"rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]} - Netlify：在项目根目录放
_redirects文件，内容写：/* /index.html 200；或用netlify.toml配置[[redirects]] from = "/*" to = "/index.html" status = 200 - 所有平台都不接受
404.htm、error.html或带查询参数的路径（如/404.html?ref=1）
本地双击打开 HTML 报“404”其实是 file:// 协议限制
这不是真正的 HTTP 404，而是浏览器出于安全考虑，禁止 file:// 协议下跨目录加载资源。现象是图片、CSS、iframe 全部失效，控制台报 Not allowed to load local resource。
- 绝对路径
file:///D:/project/sub/index.html可绕过，但不可移植，也不代表线上能跑通 - 正确做法是启动本地服务器：
python3 -m http.server 8000（Python）、npx serve -s（Node）、或 VS Code 插件 Live Server - 开发阶段就该用 HTTP 访问，避免误判路径逻辑；双击打开只适合纯单文件演示，不反映真实部署行为
最容易被忽略的是：你以为改了 HTML 里的 src 路径就能解决问题，其实真正卡住的是服务器怎么看待这个路径——它是否被声明为可服务、是否落在允许范围内、是否被重写规则覆盖。先确认服务端行为，再动前端代码。
