自动合并PR至GitHub Pages主分支后页面构建失败求助

咱们先拆解下问题核心：手动合并评论PR能正常触发页面构建，但用Mergify自动合并就失败，改个SCSS提交又能恢复——这说明自动合并的操作没正确触发GitHub Pages的构建流程，和评论内容本身无关。下面是几个针对性的解决办法，按优先级从易到难来：

1. 调整Mergify的合并方式 #

你当前用的是method: merge，这种方式会保留原分支提交记录并生成合并提交。有时候GitHub Pages对API创建的这类合并提交，触发构建的逻辑会有遗漏或延迟。可以试试换成rebase或squash方式：

pull_request_rules:
  - name: automatic merge on CI success
    conditions:
      - author=artandsuffering
      - base=master
    actions:
      merge:
        method: rebase  # 也可以换成 squash
      delete_head_branch: {}

rebase会把评论分支的提交直接放到master分支顶端，生成线性的提交记录；squash会把评论分支的所有提交合并成一个新提交。这两种方式的提交更接近手动提交的形式，大概率能触发GitHub Pages的正常构建。

2. 给Mergify添加触发构建的额外步骤 #

如果换合并方式没用，可以在合并后主动触发构建。最简单的方式是给master分支加一个空提交（不修改代码，仅触发构建）：

pull_request_rules:
  - name: automatic merge on CI success
    conditions:
      - author=artandsuffering
      - base=master
    actions:
      merge:
        method: merge
      delete_head_branch: {}
      run_command:
        command: |
          git commit --allow-empty -m "Trigger GitHub Pages build"
          git push origin master
        environment:
          name: default

注意要给Mergify配置推送master分支的权限，确保环境配置正确。

3. 查看GitHub Pages的构建日志 #

当自动合并后出现构建失败，一定要去仓库的Settings > Pages > Build and deployment里看详细日志——日志会明确告诉你失败原因，比如是不是合并后的文件路径有问题，或者Jekyll依赖加载失败？手动合并和自动合并的提交上下文可能有差异，日志能帮你精准定位问题。

4. 用GitHub Actions强制触发构建 #

如果上面的方法都不行，可以把合并和构建拆分：让Mergify负责自动合并PR，再用GitHub Actions监听master分支的push事件，强制触发完整的构建流程。创建.github/workflows/pages-build.yml文件：

name: GitHub Pages Build
on:
  push:
    branches:
      - master
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2'  # 换成你博客使用的Ruby版本
          bundler-cache: true
      - name: Build with Jekyll
        run: bundle exec jekyll build
      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./_site

这样不管是手动合并还是Mergify自动合并，只要master分支有推送，就会强制执行一次构建和部署，彻底避免GitHub Pages自动构建遗漏的问题。

如果你的博客用的是Hexo、Hugo这类其他静态站点生成器，思路也是一致的——核心是确保自动合并后的master分支提交能触发生成器的完整构建流程。

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