You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

GitHub Pages自定义域名无法重定向至index.html问题求助

排查GitHub Pages 404错误的解决方案

我来帮你搞定这个404问题,结合你收到的错误提示,咱们从几个最可能的点入手排查:

  • 确认GitHub Pages部署配置
    先去仓库的「Settings > Pages」页面,检查部署来源是不是选对了:要确保分支是你的主分支(比如main),并且选择了「/ (root)」作为部署目录。配置正确的话,页面顶部会显示绿色的“Your site is published at...”提示,确认这个地址和你的预期一致,且部署状态是成功的。

  • 严格核对文件名大小写
    错误提示里特意提到了文件名大小写匹配问题——GitHub Pages对文件名是大小写敏感的!你要去仓库根目录确认文件确实是全小写的index.html,不能是Index.html或者INDEX.HTML
    如果你本地修改了文件名大小写但Git没识别到,可以用命令强制提交变更:

    git mv Index.html index.html
    git commit -m "Fix index.html filename case"
    git push
    
  • 验证DNS记录配置
    你设置的A记录要指向GitHub Pages的官方IP地址,这四个都要添加:185.199.108.153185.199.109.153185.199.110.153185.199.111.153
    同时别忘了在仓库的「Settings > Pages」里添加自定义域名tiroltrailhead.com,添加后GitHub会自动验证DNS,这个过程可能需要等几分钟生效。你可以用nslookup tiroltrailhead.com命令在本地检查解析是否正确。

  • 检查仓库权限和部署日志
    确保你的仓库是公开的(私有仓库需要GitHub Pro/Team计划才能启用Pages服务)。另外去仓库的「Actions」页面,查看Pages部署的日志,看看有没有报错信息——哪怕是静态HTML,有时候也会因为文件权限、路径问题导致部署失败,日志里会给出具体原因。

  • 排除浏览器缓存干扰
    有时候浏览器缓存了旧的404页面,你可以用Ctrl+F5强制刷新页面,或者打开隐身模式访问,确认是不是缓存导致的问题。

内容的提问来源于stack exchange,提问作者Kay

火山引擎 最新活动