GitHub Pages构建部署失败，自定义域名codeismathiscode.org访问404求助

• DNS配置验证

  • 确认DNS记录类型：如果用A记录，必须指向GitHub官方IP（185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153）；如果用CNAME记录，要指向borgauf.github.io，不能指向其他地址。
  • 检查记录冲突：不要同时配置A记录和CNAME记录，二者选其一即可，冲突会导致DNS检查卡住。
  • 降低TTL值：把DNS记录的TTL设为300秒（5分钟），加快解析生效速度，避免旧缓存干扰。
  • 验证解析生效：用nslookup codeismathiscode.org或dig codeismathiscode.org命令，看返回的IP或CNAME是否符合要求，确认域名服务商那边的记录已经生效。

• 仓库Pages设置检查

  • 核对自定义域名拼写：确保codeismathiscode.org没有输入错误，比如少打字母、多打符号。
  • 确认CNAME文件存在：在omnimath仓库的main分支根目录，必须有一个名为CNAME的文件，内容就是codeismathiscode.org（无多余空格、换行），如果之前删除过或者没同步，会导致域名绑定失效。
  • 暂时关闭强制HTTPS：DNS检查未通过时，强制HTTPS会触发部署失败，先取消勾选，等DNS状态正常后再重新开启。

• Actions部署日志分析

  • 直接查看omnimath仓库的Actions失败日志，定位具体失败环节：是依赖安装报错？构建命令执行失败？还是权限不足？比如如果是构建脚本错误，修复对应的配置（比如.github/workflows/pages.yml里的构建命令）；如果是权限问题，确保Actions有部署Pages的权限（在仓库设置的Actions>General里，勾选相关权限选项）。

• 域名状态排查

  • 确认域名未过期：登录域名服务商后台，检查域名有效期，过期会导致解析失效。
  • 检查DNSSEC设置：如果域名开启了DNSSEC，可能和GitHub的解析不兼容，尝试暂时关闭DNSSEC，看DNS检查是否通过。

• 缓存与延迟问题

  • 清空本地DNS缓存：Windows用ipconfig /flushdns，Mac用sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder，Linux用sudo systemd-resolve --flush-caches。
  • 换网络/浏览器测试：比如用手机流量访问，排除本地网络缓存的影响；GitHub Pages部署有时会有10-30分钟延迟，最多不超过24小时，可等待一段时间再验证。

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