发布GitHub Pages站点时出现404错误该如何解决?
GitHub Pages 404错误排查步骤
- 检查Pages部署源配置
进入对应仓库的Settings页,找到左侧菜单栏的Pages选项,确认Source配置:- 分支是否选择正确(大部分场景默认用
main或master分支,用gh-pages分支部署的场景要对应选择gh-pages) - 部署目录是否选择正确,纯静态站点直接放根目录的选
/ (root),有打包输出目录的(如dist、public)要对应选择对应目录
- 分支是否选择正确(大部分场景默认用
- 检查站点入口文件
确认你选择的部署目录下存在index.html文件,GitHub Pages默认将该文件作为站点首页,注意文件名大小写完全匹配,若为Index.html、INDEX.html都无法被正常识别 - 检查部署任务状态
进入仓库的Actions标签页,查看最近的Pages部署工作流运行状态,若显示运行失败,点击对应任务查看报错详情修复即可 - 检查仓库命名规则
确认你的仓库名完全匹配你的GitHub用户名.github.io格式,大小写、字符完全对应,不能有多余字符或拼写错误 - 等待部署延迟或清除缓存
GitHub Pages部署存在最长10分钟的延迟,刚完成部署操作可以稍等几分钟后,用强制刷新(Windows按Ctrl+F5、Mac按Cmd+Shift+R)访问站点即可
内容的提问来源于stack exchange,提问作者Laily
相关产品推荐
相关产品推荐

