GitHub Action推送代码至test分支后无法触发test-workflow的解决方法

我们需要实现一条GitHub CI/CD流水线：将dev分支代码推送至test分支后，自动触发test分支的workflow。目前dev分支的dev-environ-workflow能成功完成代码推送，但test分支的test-environ-workflow在这次推送后完全没有触发。

复现结构与当前配置 #

文件结构 #

.github/
└── workflows/
    ├── dev-environ-workflow.yml  # dev分支同步流水线
    ├── test-environ-workflow.yml # test分支触发流水线

1. dev-environ-workflow.yml 现有配置 #

name: Dev to Test Sync
on:
  push:
    branches: [ dev ]

jobs:
  sync-to-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Push to test branch
        run: |
          git config --global user.name "GitHub Actions"
          git config --global user.email "actions@github.com"
          git checkout test || git checkout -b test
          git merge dev --no-edit
          git push origin test

2. test-environ-workflow.yml 现有配置 #

name: Test Branch Workflow
on:
  push:
    branches: [ test ]

jobs:
  test-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Run test tasks
        run: echo "Executing test branch deployment tasks..."

触发流程 #

1. 向dev分支推送代码，触发Dev to Test Sync流水线
2. 流水线成功将dev分支代码合并并推送到test分支
3. 预期Test Branch Workflow自动触发，但实际无执行记录

问题根源 #

GitHub Actions出于安全考虑，默认会忽略由另一个Actions工作流发起的推送操作所产生的workflow触发事件。也就是说，当你在Actions里用默认的GITHUB_TOKEN执行git push时，GitHub不会将这次推送视为触发后续workflow的有效事件。

解决方法 #

要让test分支的workflow被触发，需要用**个人访问令牌（PAT）**替代默认的GITHUB_TOKEN来完成推送操作，这样GitHub会将这次推送识别为用户发起的合法操作，进而触发对应的workflow。

具体修改步骤 #

1. 生成PAT：
   进入GitHub账号的Settings > Developer settings > Personal access tokens，创建一个新的令牌，勾选repo权限（确保有仓库读写权限），保存好令牌值（仅显示一次，务必记录）。

2. 添加仓库密钥：
   在目标仓库的Settings > Secrets and variables > Actions页面，点击New repository secret，命名为TEST_BRANCH_PUSH_TOKEN，值填入刚才生成的PAT。

3. 修改dev-environ-workflow.yml：
   有两种方式实现，选其一即可：

   方式一：推送时直接使用PAT认证

   - name: Push to test branch
     run: |
       git config --global user.name "GitHub Actions"
       git config --global user.email "actions@github.com"
       git checkout test || git checkout -b test
       git merge dev --no-edit
       # 用PAT替代默认令牌推送
       git push https://${{ secrets.TEST_BRANCH_PUSH_TOKEN }}@github.com/${{ github.repository }}.git test
   

   方式二：在checkout阶段传入PAT

   - name: Checkout code
     uses: actions/checkout@v4
     with:
       fetch-depth: 0
       token: ${{ secrets.TEST_BRANCH_PUSH_TOKEN }} # 使用PAT拉取代码，后续推送自动沿用该令牌
   
   - name: Push to test branch
     run: |
       git config --global user.name "GitHub Actions"
       git config --global user.email "actions@github.com"
       git checkout test || git checkout -b test
       git merge dev --no-edit
       git push origin test
   

注意事项 #

• 确保PAT的repo权限已勾选，否则无法完成推送操作。
• 绝对不要将PAT明文写在workflow文件中，必须存在仓库的Secrets里。
• 如果是组织仓库，要确认PAT的拥有者对该仓库有推送权限。

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