删除并重建同名Github Pages仓库后访问出现404错误如何解决

问题原因 #

• GitHub CDN 缓存残留：旧仓库的Pages站点内容会被GitHub全球CDN缓存，删除仓库后缓存不会立即失效，重建同名仓库后请求仍然命中旧的失效缓存，返回404
• Pages 服务配置未正确开启：重建仓库后默认不会自动开启Pages服务，或开启时选择的部署分支、部署目录与实际代码存放位置不一致
• 站点入口缺失：仓库根目录或指定部署目录下不存在index.html作为站点入口文件
• 构建部署未完成：GitHub Pages需要完成自动构建流程后才能对外提供服务，刚完成仓库重建立刻访问会因部署未完成返回404
• 自定义域名配置失效：如果旧仓库绑定了自定义域名，重建后未重新配置Pages的域名选项或仓库内的CNAME文件，会导致域名匹配失败

解决步骤 #

• 第一步：确认基础配置
  进入仓库的Settings页面，找到Pages配置栏，确认已开启Pages服务；检查部署源配置，分支要和你推送代码的分支（一般为main或master）一致，部署目录根据你的站点类型选择，普通静态站点选择根目录/，用docs目录存放代码则选择/docs。
• 第二步：确认构建流程正常
  进入仓库的Actions标签页，查看最近的构建部署任务是否成功执行，若有报错根据提示修复代码或配置问题后重新提交。如果没有触发构建任务，可以对代码做任意小修改（比如修改README文件的内容）后重新推送，手动触发构建。
• 第三步：缓存清理与验证
  构建部署成功后，用浏览器无痕模式访问站点，或者按Ctrl+F5强制刷新跳过本地缓存。如果仍然返回404，等待10-30分钟让GitHub CDN的旧缓存自动过期即可正常访问，最长等待时间不会超过1小时。
• 第四步：自定义域名适配（仅针对使用自定义域名的场景）
  若你的站点绑定了自定义域名，需要在Pages配置栏重新填写自定义域名，同时确认域名解析商的CNAME记录仍然指向christianbauer1.github.io；另外需要确保仓库根目录下存在CNAME无后缀文件，文件内容为你的自定义域名，无多余字符。

内容的提问来源于stack exchange，提问作者christianbauer1