GitHub Pages访问被重定向到奇怪临时URL是什么原因？

架构老林

2026-8-30

问题成因

你看到的https://<随机词组>-<哈希值>.pages.github.io类域名不是异常地址，是GitHub Pages新架构下的预览/临时部署默认域名，访问正式地址被跳转到这类域名，核心原因是当前仓库的Pages生产部署流程未正常生效，请求被路由到了临时预览部署实例，常见触发原因如下：

仓库Pages源配置错误：选择了「Deploy from a workflow」模式但未使用官方生产部署组件，或使用了第三方过时部署脚本，触发的是临时预览部署而非正式生产部署
权限或配置冲突：组织级<organization>.github.io根仓库Pages服务异常、组织Pages权限设置限制了当前项目仓库的生产发布、仓库可见性与Pages发布范围不匹配，都会导致生产部署校验失败，自动回退到临时部署实例
静态配置错误：gh-pages分支内的CNAME、_redirects文件存在错误跳转规则，把正式路径请求强制导到了临时部署域名
缓存命中：开启了PR预览部署功能后，当前gh-pages分支最新提交未触发生产部署流水线，访问正式地址时命中了最近一次成功的预览部署缓存

注意：项目仓库的gh-pages分支部署天然不会自动同步文件到<organization>.github.io根仓库，两者是完全独立的部署目标：根仓库对应<organization>.github.io根域站点，项目仓库对应<organization>.github.io/<repo>子路径站点。你手动复制文件到根仓库能访问属于绕开项目部署流程的取巧操作，不是正确解法。

修复步骤

按优先级从高到低排查操作：

重置基础Pages配置
- 进入仓库Settings -> Pages页面，将Source选项切换为Deploy from a branch，分支选择gh-pages，发布目录选择/ (root)，保存配置
- 进入仓库Actions页面，取消所有运行中、失败的历史Pages部署任务，手动触发一次全新部署
- 等部署完成后查看部署日志标注的正式访问地址，如果显示为<organization>.github.io/<repo>，清空浏览器301跳转缓存（或用无痕模式）访问即可
修正工作流部署配置（仅需要自定义构建流程时使用）
- 如果你需要用自定义工作流构建站点后再发布，必须使用官方actions/deploy-pages组件，且配置中明确指定生产环境，不要使用默认预览环境配置，核心配置参考：
```
jobs:
  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      # 这里放你自己的站点构建步骤
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4
```
- 不要使用来源不明的第三方Pages部署Action，这类工具多数默认走临时预览部署通道，不会发布到正式生产地址
排查静态配置冲突
- 检查gh-pages分支根目录的CNAME文件：如果没有配置自定义域名，直接删除该文件；如果配置了自定义域名，确认文件内域名填写正确
- 检查gh-pages分支内的_redirects文件，删除所有指向*.pages.github.io临时域名的跳转规则
清理旧部署与缓存
- 进入仓库Settings -> Environments页面，删除除github-pages之外的所有Pages相关环境（常见名称为preview、github-pages-preview）
- 清空本地浏览器对应域名的缓存、DNS缓存后重新测试
组织级配置排查（仅组织仓库需要）
- 联系组织管理员进入组织Settings -> Pages页面，确认当前仓库有公开发布Pages站点的权限，没有被组织策略拦截
- 确认组织的<organization>.github.io根仓库Pages服务部署正常，根仓库部署异常会导致所有子路径项目站点路由失效

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