上线初期HTML频繁404，主因是部署路径、服务映射或静态资源发布流程未对齐；需重点核查三件事：文件是否真在DocumentRoot下、请求路径是否被路由/重写规则拦截、服务器是否将.html误作动态资源处理。
上线初期HTML频繁404，基本不是代码逻辑问题，而是部署路径、服务映射或静态资源发布流程没对齐。先别改前端代码，重点查三件事：文件是否真在服务器对应位置、请求路径是否被路由/重写规则吃掉、服务器是否把.html当动态资源拦截了。
确认HTML文件是否落在Web服务器的DocumentRoot下
很多新手把HTML文件直接丢进项目根目录就跑npm start或双击打开file://，这根本没走HTTP服务——浏览器地址栏显示file:///时，任何相对路径引用CSS/JS都会失败，且无法触发404（那是浏览器本地行为）。必须用HTTP协议访问：
- Apache用户检查
httpd.conf里的DocumentRoot指向是否包含你的HTML文件所在目录 - Nginx用户核对
server块中root或alias配置，注意alias末尾斜杠和路径拼接关系 - Node.js用户（如
express.static()）确认app.use(express.static('public'))的public目录里确实有index.html，而不是只放了src/或dist/子目录 - 用
curl -I http://localhost:3000/index.html看返回状态码，别只信浏览器刷新
检查URL路径与实际文件系统路径是否严格一致
大小写、斜杠、扩展名，一个字符不对就是404。Linux服务器区分/About.html和/about.html；Windows虽不敏感，但Nginx/Apache默认按文件系统行为处理。常见坑：
html-to-pptx-converter
下载
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
- Git提交时文件名变成
index.HTML（Windows上可能看不见），但服务器读取时找不到index.html - 构建工具（如Vite/Vue CLI）输出的
dist/里是index.html，但你配的Nginxroot指向的是dist的父目录 - URL里写了
/pages/contact.html，但文件实际在dist/pages/contact.htm（少个l） - 使用
history.pushState的SPA没配fallback，访问/user/123时服务器去查这个路径下的HTML文件——当然不存在
排查服务器是否错误地拦截或重写.html请求
某些CMS、安全插件或老旧配置会把.html后缀强制重定向到无后缀URL，或交给PHP/Java处理，导致静态文件被跳过。典型表现：首页/能打开，但/index.html报404。
立即学习“前端免费学习笔记（深入）”；
- Apache检查
.htaccess里是否有RewriteRule匹配\.html$并做了R=301或R=404 - Nginx查看是否有
location ~ \.html$ { ... }块，里面写了deny all或proxy_pass到后端 - Tomcat用户注意
web.xml里<welcome-file-list></welcome-file-list>是否只列了index.jsp没加index.html，导致/请求不命中 - CDN或WAF控制台里是否启用了“隐藏.html后缀”或“SEO优化重写”，关掉测试
上线初期最容易被忽略的是：你以为部署完了，其实CI/CD流水线只上传了build/目录，而服务器配置读的是public/；或者Git忽略规则把.html文件过滤掉了。用ls -la连上服务器直接看真实文件结构，比猜快十倍。
