GitHub Pages自定义域名配置后其他仓库无法使用求助

核心排查步骤 #

• 检查项目仓库的GitHub Pages配置
  进入每个项目仓库的「Settings」→「Pages」：

  1. 在「Custom domain」输入框中，必须填写你的根域名（比如custom.domain），不能填带项目路径的地址（比如custom.domain/project-name）
  2. 保存设置后，GitHub会自动在项目仓库的根目录生成一个CNAME文件，文件内容就是你的根域名，不要修改这个文件
  3. 确认「Source」部分的分支和部署路径正确（比如选main分支，部署路径选/root或/docs，根据你的项目结构调整）

• 验证主站点配置的关联性
  你的用户站点（username.github.io仓库）已配置成功，但要确保：

  1. 主站点的「Custom domain」同样设置为custom.domain
  2. 主站点的CNAME文件内容是custom.domain，未被篡改

• 检查DNS配置的完整性
  你已配置4条A记录，这部分没问题，但额外确认：

  1. 无需为项目子路径单独配置DNS记录（GitHub Pages不要求这个）
  2. 如果DNS中有其他冲突记录（比如旧的CNAME或A记录指向其他服务商），请删除

• 等待部署同步与缓存刷新

  1. 配置完成后，GitHub Pages需要10-30分钟同步域名配置，不要急于测试
  2. 强制刷新浏览器缓存（按Ctrl+F5），或用无痕模式访问custom.domain/project-name
  3. 查看仓库的「Actions」→「Pages build and deployment」日志，确认部署无报错

常见误区提醒 #

• 不要在项目仓库的CNAME文件中添加项目路径，只保留根域名即可
• 不要给项目站点配置子域名（比如project.custom.domain），除非你确实需要子域名访问而非子路径
• 如果勾选了「Enforce HTTPS」，要等GitHub完成SSL证书颁发后再访问，否则会出现HTTPS错误

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