You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.04 04:06:03