Github Pages 部署出现 File not found 404 错误无法访问如何解决
GitHub Pages 404报错排查方案
- 确认仓库命名合规:你当前使用的
knoxnethan.github.io命名符合GitHub Pages个人站点的命名规则,该配置没有问题,无需修改。 - 核查部署分支配置:进入对应仓库的
Settings页面,找到侧边栏的Pages选项,确认Source模块指定的部署分支与你推送静态文件的分支一致,常规部署场景可选main分支根目录,使用Hexo、Hugo等静态站点生成工具的场景通常选择gh-pages分支。 - 检查站点入口文件:部署分支的根目录必须存在
index.html或index.md作为默认入口,GitHub Pages对文件名大小写敏感,若入口文件命名为Index.html这类大小写不匹配的形式,会直接触发404报错。 - 等待部署任务执行完成:配置修改或代码推送后,GitHub Pages需要1-5分钟的构建部署时间,你可以进入仓库的
Actions标签页查看部署任务进度,待任务显示成功后再访问站点即可。 - 清理本地缓存重试:若部署完成后仍显示404,可按
Ctrl+Shift+R强制刷新页面,或使用浏览器无痕模式访问,排除本地缓存旧报错页面的影响。
如果你的站点是Vue、React等单页应用,还需补充以下配置:
单页应用依赖前端路由实现路径跳转,直接访问子路由时会触发404,你需要在打包后的静态文件根目录下,新增一份和
index.html内容完全相同的404.html文件,同时在index.html的head标签中配置匹配站点路径的base属性。
内容的提问来源于stack exchange,提问作者Knox-Nethan
相关产品推荐
相关产品推荐

