Github Actions拉取仓库合并分支出现异常问题求助

问题场景 #

使用actions/checkout@v3拉取指定分支后执行合并操作：

- uses: actions/checkout@v3
  with:
    repository: myorg/myrepo
    ref: mybranch
    token: ${{ secrets.ACCESS_TOKEN }}

- run: |
    git config --global user.email "me@myorg.com"
    git config --global user.name "me"
    git fetch
    git merge mybranch origin/${{ env.ANOTHER_BRANCH}}

首次执行报错：

fatal: refusing to merge unrelated histories

添加--allow-unrelated-histories参数后，又出现无意义的合并冲突，但本地拉取分支合并、创建PR时均无冲突，仅在GitHub Actions环境中触发问题。

核心原因 #

actions/checkout@v3默认采用浅克隆（shallow clone），仅拉取指定分支的最新提交，不会同步完整仓库历史。由于两个分支的共同祖先（main分支）不在浅克隆的历史范围内，Git无法识别分支关联性，误判为无关历史；强制合并后，缺失的历史上下文会导致Git错误识别冲突。

解决思路 #

1. 拉取完整仓库历史
   修改actions/checkout配置，添加fetch-depth: 0拉取全量历史，让Git能识别分支的共同祖先：

- uses: actions/checkout@v3
  with:
    repository: myorg/myrepo
    ref: mybranch
    token: ${{ secrets.ACCESS_TOKEN }}
    fetch-depth: 0  # 拉取完整仓库历史

2. 单独拉取目标分支的完整历史
   如果不需要全仓库历史，可在checkout后单独拉取目标分支的完整提交：

- run: |
    git config --global user.email "me@myorg.com"
    git config --global user.name "me"
    git fetch origin ${{ env.ANOTHER_BRANCH }} --depth=0
    git merge origin/${{ env.ANOTHER_BRANCH }}

注意：当前已处于mybranch分支，合并命令无需重复指定mybranch

3. 验证历史完整性
   合并前可通过日志确认分支历史是否包含共同祖先：

- run: git log --oneline --graph mybranch origin/${{ env.ANOTHER_BRANCH }}

若日志中能看到共同的main分支提交，说明历史拉取完整，合并操作可正常执行。

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