如何强制GitHub更新PR合并分支以适配修复后的目标分支？

背景 #

Dependabot提交了一个批量升级NPM依赖的PR，但其中的package-lock.json存在错误，导致npm ci执行失败。遗憾的是，我们在发现问题前已经合并了该PR。

之后我们创建了两个修复PR：

• 回退那个有问题的Dependabot PR；
• 修改CI工作流，将npm install替换为npm ci，确保后续PR更新package.json时若未同步更新package-lock.json能及时发现问题。

在此期间，Dependabot又提交了几个无问题的PR，但出现了以下矛盾情况：

• 本地用gh pr checkout <NNNN>检出PR分支，测试可通过；
• 本地将PR分支合并到目标分支（使用git merge <PR_BRANCH>或--squash参数）后，组合代码的测试也能通过；
• 但GitHub上运行PR测试时失败，原因是CI的checkout action会拉取PR合并分支refs/pull/PULL_REQUEST_NUMBER/merge，而这个分支存在问题——推测是PR创建时目标分支仍处于异常状态导致的。

解决方法 #

方法1：触发Dependabot自动更新 #

在PR的评论区输入以下命令之一，Dependabot会基于最新的目标分支重新处理PR，自动更新GitHub生成的合并分支：

• 变基PR：@dependabot rebase
• 重新创建PR：@dependabot recreate
  （注：最初误以为这两个命令无效，实际可解决问题）

方法2：手动更新PR分支 #

如果Dependabot未响应，可手动在本地操作后推送：

1. 检出并拉取最新的目标分支（以main为例）：

   git checkout main
   git pull origin main
   

2. 检出PR分支并变基到最新目标分支：

   git checkout <PR_BRANCH_NAME>
   git rebase main
   

3. 安全强制推送到远程PR分支（若有其他协作者需提前沟通）：

   git push origin <PR_BRANCH_NAME> --force-with-lease
   

完成后，GitHub会自动重新生成refs/pull/PULL_REQUEST_NUMBER/merge分支，同步到最新的目标分支状态。

方法3：使用GitHub的“更新分支”按钮 #

虽然官方文档说明该按钮用于更新PR分支，但点击它（选择合并或变基目标分支到PR分支）后，GitHub会重新计算合并分支，使其与已修复的目标分支保持同步。

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