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

求助:我的GitHub Page直接跳转404页面,网站无法运行

GitHub Pages 跳转404问题排查与解决

以下是常见的排查方向和解决方法:

  • 检查GitHub Pages配置:进入仓库「Settings」→「Pages」,确认源分支和目录选择正确(比如main分支的/(root)或/docs目录),选错分支/目录会直接导致404。同时确保仓库是公开状态,私有仓库免费版无法启用Pages服务。
  • 验证首页文件:确保仓库根目录(或指定的Pages目录)存在index.html(或index.md,若使用Jekyll),GitHub Pages默认以此作为站点入口,缺失会触发404。注意文件名大小写敏感,Index.html和index.html会被视为不同文件,统一用小写命名。
  • 排查Jekyll配置(若使用):打开_config.yml,检查baseurl设置——如果你的站点地址是用户名.github.io/仓库名,baseurl必须设为/仓库名,否则页面资源路径会错误导致404。同时查看仓库「Actions」标签页的构建日志,若构建失败,根据提示修复语法或依赖问题。
  • 等待构建完成:推送代码后GitHub Pages需要5-10分钟完成构建,刚提交就访问可能会出现临时404,稍等片刻再重试。
  • 自定义域名检查(若使用):确认域名解析记录正确(CNAME指向用户名.github.io,A记录指向GitHub官方IP),同时仓库根目录的CNAME文件内容要和自定义域名完全一致,不能有拼写或格式错误。
  • 清理浏览器缓存:按下Ctrl+F5强制刷新页面,避免本地缓存的旧404页面干扰。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.14 17:25:25