当main分支推送时更新所有分支的GitHub Action报错求助

核心问题修复 #

原配置的actions/checkout@v2默认是浅克隆+仅拉取当前分支，导致本地仓库没有其他远程分支的本地副本，执行git checkout时自然找不到对应分支。需要修改checkout步骤拉取完整仓库，并同步所有远程分支。

修正后的GitHub Action配置 #

name: Update Branches

on:
  push:
    branches:
      - main

jobs:
  update-branches:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout full repository
        uses: actions/checkout@v4  # 升级到最新稳定版更可靠
        with:
          fetch-depth: 0  # 拉取完整仓库历史，包括所有分支
          ref: main

      - name: Configure git identity
        run: |
          git config user.name "GitHub Actions"
          git config user.email "actions@github.com"

      - name: Get all non-main branch names
        id: branches
        run: |
          # 获取远程分支列表并过滤main，去除origin/前缀后写入文件
          git branch -r | grep -v 'main$' | sed 's/origin\///' > ${{ github.workspace }}/branches.txt

      - name: Update each branch
        run: |
          while read -r branch; do
            # 创建本地分支并追踪对应远程分支
            git checkout -b $branch origin/$branch
            # 合并main分支，自动使用默认提交信息
            git merge origin/main --no-edit
            # 推送更新到远程分支
            git push origin $branch
          done < ${{ github.workspace }}/branches.txt

关键修改点说明 #

• checkout步骤：通过fetch-depth: 0拉取完整仓库，确保本地能获取所有远程分支的信息；升级到actions/checkout@v4规避旧版本的潜在兼容性问题。
• git身份配置：设置用户信息，避免merge、push操作时出现身份验证报错。
• 分支获取逻辑：改用git branch -r读取远程分支列表，再去除origin/前缀，适配本地仓库的分支引用规则，比git ls-remote更直接。
• 分支检出方式：用git checkout -b $branch origin/$branch创建本地分支并绑定远程分支，确保本地有可用的分支副本。

冲突处理说明 #

如果目标分支和main存在代码冲突，git merge会失败并终止Action。若需要自动处理简单冲突，可以在merge命令后添加--strategy-option theirs（以main分支内容为准自动解决冲突），但需谨慎使用：

git merge origin/main --no-edit --strategy-option theirs

替代方案：无需本地checkout的批量更新 #

如果目标分支完全依赖main更新（允许覆盖分支原有修改），可以用更简洁的强制推送方案：

name: Force Update Branches from Main

on:
  push:
    branches:
      - main

jobs:
  force-update:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Configure git identity
        run: |
          git config user.name "GitHub Actions"
          git config user.email "actions@github.com"

      - name: Force push main to all non-main branches
        run: |
          git branch -r | grep -v 'main$' | sed 's/origin\///' | while read branch; do
            git push origin main:$branch --force
          done

注意：此方案会完全覆盖目标分支的所有修改，仅适用于分支无需保留独立变更的场景。

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