Github Pages设置完成后站点无法加载问题排查求助
陌生域名test-blog-on-qa.com来源说明
该域名不是Github官方默认分配的Pages域名,出现该配置仅两种可能:
- 你在仓库Pages设置的自定义域名输入框中误填写了该域名
- 仓库根目录下存在内容为该域名的
CNAME文件
Github官方默认分配的Pages域名格式为<用户名>.github.io/<仓库名>,你的站点默认官方域名应为jchu4483.github.io/auth0。
站点无法访问排查方案
- 清理错误自定义域名配置:进入仓库
Settings→Pages页面,删除Custom domain输入框内的test-blog-on-qa.com内容后保存。 - 清理仓库内的
CNAME文件:如果仓库根目录存在该文件,直接删除后提交推送至main分支。 - 确认发布源配置:检查Pages设置下
Build and deployment区域,Source选择Deploy from a branch,Branch配置为main分支、目录选择/(root),确认配置无误后保存。 - 检查Jekyll配置合法性:确认根目录
_config.yml文件无语法错误,常见错误包括缩进不规范、必填字段留空、特殊字符未转义,错误的配置会直接导致站点构建失败。 - 查看构建日志定位问题:进入仓库
Actions选项卡,找到最近的Pages构建任务,查看构建流程的报错提示,根据报错信息修正对应配置即可。 - 等待生效:所有配置修改完成后,Github Pages需要2-10分钟完成更新,生效后访问
jchu4483.github.io/auth0即可正常加载站点。
内容的提问来源于stack exchange,提问作者Jason Chu
相关产品推荐
相关产品推荐

