PR与基础分支冲突时，如何触发GitHub Action的pull_request事件？

无需临时分支的长期方案 #

1. 改用pull_request_target事件 #

pull_request_target事件会在PR创建/更新时触发，即使PR与基础分支存在冲突——因为它基于基础分支的上下文执行工作流，而非PR分支。你可以通过该事件获取PR的基础分支信息，再拉取PR分支代码完成构建：

on:
  pull_request_target:
    types: [opened, synchronize, reopened]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取PR分支代码
        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.ref }}
          repository: ${{ github.event.pull_request.head.repo.full_name }}
          persist-credentials: false

      - name: 配置基础分支环境变量
        run: echo "BASE_BRANCH=${{ github.base_ref }}" >> $GITHUB_ENV

      - name: 基于缓存构建Docker镜像
        run: |
          docker build . \
            --cache-from $ECR_REPO/${{ env.BASE_BRANCH }}:latest \
            --tag $ECR_REPO/${{ github.head_ref }}:latest

注意：pull_request_target拥有基础分支的权限，需确保PR分支代码可信，避免执行恶意脚本。

2. 结合push事件与GitHub API获取基础分支 #

利用push事件不受冲突影响的特性，在触发时通过GitHub API查询当前分支关联的PR，提取基础分支信息：

on:
  push:
    branches:
      - feature/**

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 通过API获取基础分支
        id: get-base-branch
        run: |
          PR_DATA=$(gh pr view ${{ github.ref_name }} --json baseRefName)
          BASE_BRANCH=$(echo "$PR_DATA" | jq -r '.baseRefName')
          echo "BASE_BRANCH=$BASE_BRANCH" >> $GITHUB_ENV
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: 基于缓存构建Docker镜像
        run: |
          docker build . \
            --cache-from $ECR_REPO/${{ env.BASE_BRANCH }}:latest \
            --tag $ECR_REPO/${{ github.ref_name }}:latest

默认GITHUB_TOKEN已具备调用GitHub API的权限，无需额外配置。

3. 启用workflow_dispatch手动触发 #

给工作流添加手动触发支持，可直接指定基础分支和PR分支，完全绕开冲突限制：

on:
  workflow_dispatch:
    inputs:
      head_branch:
        description: 'PR分支名称'
        required: true
      base_branch:
        description: '基础分支名称'
        required: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取指定PR分支代码
        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.inputs.head_branch }}

      - name: 基于缓存构建Docker镜像
        run: |
          docker build . \
            --cache-from $ECR_REPO/${{ github.event.inputs.base_branch }}:latest \
            --tag $ECR_REPO/${{ github.event.inputs.head_branch }}:latest

使用时直接在GitHub Actions页面选择该工作流，输入分支名称即可触发构建。

更简便的临时方案 #

1. 给PR分支添加空提交 #

无需创建新分支，直接在冲突分支上生成一个空提交并推送，可触发pull_request事件：

git commit --allow-empty -m "触发冲突PR的工作流"
git push origin feature/first_branch

空提交不会改变代码内容，但会让GitHub检测到分支更新，从而触发工作流。

2. 手动重新触发工作流 #

如果PR已创建但工作流未触发，可直接在GitHub Actions页面找到对应工作流，点击右上角的「Re-run jobs」按钮强制触发——即使PR仍存在冲突。

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