本地可用的GitHub PAT在Actions中推送至保护分支失败求助

问题描述 #

我尝试通过GitHub Action执行bash脚本生成文件后，推送到仓库的保护分支（develop/main），但触发报错：

remote: error: GH006: Protected branch update failed for refs/heads/develop.        
remote: error: Waiting on code owner review from users        
To https://github.com/ORG/REPO.git
 ! [remote rejected] develop -> develop (protected branch hook declined)
error: failed to push some refs to 'https://github.com/ORG/REPO.git'
Error: Process completed with exit code 1.

本地使用管理员账号的个人访问令牌（PAT）测试推送正常，但在GitHub Action中执行相同逻辑时失败。

修复方案 #

1. 检查并更新PAT权限 #

创建PAT时必须勾选以下关键权限：

• 勾选repo分类下的所有权限（确保拥有推送代码的权限）
• 勾选workflow权限（允许操作GitHub Actions相关内容）
  重新生成PAT后，更新仓库的GACDTOK密钥。

2. 配置分支保护规则的绕过权限 #

进入仓库的「Settings」→「Branches」→「Branch protection rules」，找到对应保护分支的规则：

• 开启「Allow specified actors to bypass required pull requests」选项
• 将创建PAT的管理员账号添加到允许列表中
  使该账号的PAT能绕过分支保护的审核要求。

3. 修正GitHub Action配置中的错误 #

（1）修复环境变量引用错误

原脚本中git remote set-url的ACCESS_TOKEN未正确解析，需改为：

git remote set-url origin https://username:${ACCESS_TOKEN}@github.com/ORG/REPO.git

也可直接使用密钥变量：

git remote set-url origin https://username:${{ secrets.GACDTOK }}@github.com/ORG/REPO.git

（2）修复分支切换逻辑

在push触发的Action中，github.head_ref为空值，需改用github.ref_name切换到当前分支：

- run: git checkout ${{ github.ref_name }}

（3）避免循环触发Action

推送操作会再次触发push事件导致无限循环，需在commit信息中加入[skip ci]：

git commit -m "commit msg [skip ci]"

修正后的完整Action配置 #

name: "Generate Proto Stubs"
on: 
  push:
    branches:
      - main
      - develop
env:
  ACCESS_TOKEN: ${{ secrets.GACDTOK }}
jobs:
  proto_gen:
    name: generating stubs 
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0
      - run: git checkout ${{ github.ref_name }}
      - uses: actions/setup-python@v4
        with:
          python-version: '3.9' 
      - run: pip install grpcio==1.35.0 protobuf==3.14.0 grpcio-tools==1.35.0
      - run: |           
          bash scripts/make_proto.sh
          git config user.name "username"
          git config user.email "email"
          git remote set-url origin https://username:${ACCESS_TOKEN}@github.com/ORG/REPO.git
          git add .
          git commit -m "Generate proto stubs [skip ci]"
          git push

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