为何我的GitHub App无法绕过分支保护规则？

可能的原因及修复步骤 #

1. 分支保护规则未正确添加App的机器人账号 #

分支保护规则中需要添加的是GitHub App的安装机器人账号，而非App的显示名称：

• 打开目标仓库的「Settings」→「Branches」，找到main分支的保护规则并编辑
• 在「Allow specified actors to bypass required pull requests」搜索框中，输入你的GitHub App名称，选择带[bot]后缀的账号（例如AutoCommit App[bot]），添加到列表后保存

2. Workflow未正确切换到最新的main分支 #

如果Workflow触发事件是pull_request，默认checkout的是PR分支而非main分支，可能导致提交上下文异常：
修改Workflow中的提交步骤，先切换并拉取最新main分支：

- name: Commit automatic version bump
  if: github.event.pull_request.merged == true
  env:
    GITHUB_TOKEN: ${{ steps.get_workflow_token.outputs.token }}
  run: |-
    git fetch origin main
    git checkout main
    git config user.name 'autocommit app'
    git config user.email 'autocommit-app@placeholder.com'
    # 执行版本更新操作（比如修改version文件）
    git add .
    git commit -m "chore: update version number (automated)"
    git push origin main

3. 确认GitHub App的权限配置 #

确保App拥有仓库的Administration（读写）权限：

• 进入组织的「Settings」→「GitHub Apps」，找到你的App并编辑
• 在「Repository permissions」→「Administration」，确认权限设置为「Read and write」，保存后重新安装App到目标仓库

4. 验证令牌的权限有效性 #

可以在Workflow中添加步骤验证生成的令牌权限：

- name: Check token permissions
  env:
    GITHUB_TOKEN: ${{ steps.get_workflow_token.outputs.token }}
  run: |-
    curl -s -H "Authorization: token $GITHUB_TOKEN" \
    https://api.github.com/repos/${{ github.repository }}/collaborators/[你的App机器人账号]/permission

返回结果中permission字段应为admin或maintain，确保拥有绕过分支保护的权限

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