Github Actions自动合并main到受保护develop分支失败求助

你遇到的GH006错误是因为develop分支的保护规则要求审核，但你的Actions操作未满足绕过条件。以下是具体排查和解决步骤：

1. 确认PAT的权限与分支保护配置 #

• 确保adminUserToken是仓库管理员账号生成的Personal Access Token（PAT），且勾选了repo全权限（包含所有子权限）。
• 进入仓库Settings > Branches，找到develop分支的保护规则：
  • 开启允许绕过提交审核选项，将该PAT对应的用户账号添加到允许列表中；
  • 若有状态检查要求，同步开启对应绕过选项并添加用户。

2. 修正工作流的token传递方式 #

原工作流通过env设置GITHUB_TOKEN可能无法被git push正确识别，建议直接在actions/checkout步骤传入token，同时拉取完整仓库历史避免浅克隆问题：

- uses: actions/checkout@v4
  with:
    token: ${{ secrets.adminUserToken }}
    fetch-depth: 0  # 拉取全量历史，替代git fetch --unshallow

3. 优化合并与推送逻辑 #

• 移除git push --force，强制推送会触发额外分支保护限制，改用普通推送即可；
• 合并前明确拉取远程develop最新代码，避免本地分支过时导致冲突或推送失败：

git checkout develop
git pull origin develop
git merge --no-ff ${{ github.base_ref }} -m "Auto-merge ${{ github.base_ref }} back to develop"
git push origin develop

修正后的完整工作流配置 #

name: Auto merge main/master to develop branch
on:
  pull_request:
    branches: [main, master]
    types: [closed]
jobs:
  merge-back:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    steps:
      - name: Checkout full repository
        uses: actions/checkout@v4
        with:
          token: ${{ secrets.adminUserToken }}
          fetch-depth: 0

      - name: Set Git user info
        run: |
          git config --local user.email "actions@github.com"
          git config --local user.name "GitHub Actions"

      - name: Merge main/master to develop
        run: |
          git checkout develop
          git pull origin develop
          git merge --no-ff ${{ github.base_ref }} -m "Auto-merge ${{ github.base_ref }} back to develop"
          git push origin develop

额外排查点 #

• 测试PAT有效性：本地执行git clone https://<PAT>@github.com/blabla/blabla-repo.git，尝试推送代码确认权限正常；
• 检查分支保护规则是否开启了其他限制（如线性提交历史），如有则同步调整绕过配置。

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