已开启强制推送仍触发Github保护分支钩子拒绝错误

问题核心原因 #

你的test分支开启了**“要求所有提交都通过拉取请求合并”**的分支保护规则，这条规则会直接阻止任何直接推送操作（包括--force强制推送）。即使你开启了“允许所有人强制推送”，该权限仅允许用户执行强制推送动作，但无法绕过“必须通过PR合并”的核心保护规则。

解决方案 #

方案一：给GitHub Actions Bot赋予分支保护绕过权限（推荐） #

1. 进入仓库的 Settings → Branches → Branch protection rules，找到test分支的保护规则并编辑
2. 找到Allow specified actors to bypass required pull requests选项，添加github-actions[bot]账号
3. 保存规则后，调整Workflow配置，确保Actions使用的凭证拥有正确权限：
   修改actions/checkout和提交步骤：

   - uses: actions/checkout@v3
     with:
       ref: ${{ steps.branch-name.outputs.base_ref_branch }}
       persist-credentials: false # 禁用默认凭证，避免权限不足
   
   - name: Configure Git identity
     run: |
       git config --global user.name "github-actions[bot]"
       git config --global user.email "github-actions[bot]@users.noreply.github.com"
   
   - name: Commit changes
     uses: stefanzweifel/git-auto-commit-action@v4
     with:
       commit_message: "version: update patch"
       branch: ${{ steps.branch-name.outputs.base_ref_branch }}
       push_options: '--force'
       token: ${{ secrets.GITHUB_TOKEN }} # 使用仓库默认的GITHUB_TOKEN
   

方案二：临时调整分支保护规则（不推荐） #

编辑test分支的保护规则，暂时关闭**“要求所有提交都通过拉取请求合并”**选项，或添加例外规则允许指定账号直接推送。此方法会降低分支安全性，仅适合临时测试场景。

额外验证步骤 #

可以在Workflow中添加调试步骤，确认分支名称变量是否正确：

- name: Debug branch info
  run: |
    echo "Base branch: ${{ steps.branch-name.outputs.base_ref_branch }}"
    echo "Current branch: ${{ steps.branch-name.outputs.current_branch }}"

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