静态网站上传后出现 404,应先把访问 URL 与配置的网站根目录逐项对照。传输成功只说明文件到达服务器,实际页面可能多放了一层目录。先选择一个确定存在的文件,明确它应该通过哪个地址访问。
区分首页和内页
分别访问域名根路径和明确的首页文件,例如 /index.html。文件能打开、根路径不能打开时,检查默认文档配置;两者都失败时,确认域名连接的是目标网站,网站根目录里确实包含本次产物。
内页应对照生成后的文件结构:可能是 services.html,也可能是目录下的 index.html。单页应用可能需要回退规则,多页静态导出则应包含对应页面。先确认产物类型,再决定是否添加重写。
精确比较路径
- 检查首页上方是否意外多了一层 export 或 dist 文件夹。
- 对照 URL 检查文件拼写、扩展名与字母大小写。
- 检查脚本和样式是否使用正确的基础路径。
- 在新标签中直接打开内页并刷新。
- 用浏览器网络面板区分页面文档失败与资源文件失败。
不要为了隐藏报错,把所有不存在的 URL 都返回成成功首页;这样会让真正缺失的页面和损坏资源更难定位。
给技术支持一个可复现问题
提供失败的完整地址、预期文件位置、响应状态和上传时间。可以附上排除私密文件后的目录结构截图。如果首页正常,也一并提供成功地址;两者差异常能缩小排查范围。
下方的两页静态演示可作为对照:如果明确的 HTML 文件在相同目录正常工作,再比较你自己导出的结构和路径规则。