GitHub Actions：PR评论/retest触发构建后PR页面不显示运行状态问题

问题原因 #

通过issue_comment触发的工作流默认不会自动关联到PR的检查项——这类工作流的触发上下文是评论事件，而非PR本身的打开/同步事件，因此GitHub不会自动将其展示在PR的检查区域。

解决方案 #

需要传递PR提交的SHA值给被调用的工作流，同时调整权限和参数逻辑，让工作流关联到PR的目标提交，从而在PR页面显示检查状态。

1. 修改调用工作流（Pull request comment） #

更新权限并补充参数传递，确保仅针对PR评论触发：

# Workflow for retrigger pr builder on comment and reuse workflow
# caller workflow
name: Pull request comment
on:
  issue_comment:
    types: [created]

permissions:
  contents: read
  pull-requests: write  # 新增：需要该权限更新PR检查状态

jobs:
  build:
    uses: ./.github/workflows/pr-build.yml
    # 新增条件：仅在PR评论且包含/retest时触发
    if: contains(github.event.comment.body, '/retest') && github.event.issue.pull_request
    secrets: inherit
    with:
      # 传递PR编号和head提交SHA给被调用工作流
      pr_number: ${{ github.event.issue.number }}
      head_sha: ${{ github.event.issue.pull_request.head.sha }}

2. 修改被调用工作流（pr-build.yml） #

添加工作流调用的参数定义，并确保检查步骤关联到PR的head提交：

name: PR Build
on:
  pull_request:
    types: [opened, synchronize, reopened]
  # 新增：接收调用方传递的参数
  workflow_call:
    inputs:
      pr_number:
        type: number
        required: true
      head_sha:
        type: string
        required: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      # 调整checkout步骤，使用传递的head_sha关联到PR提交
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          ref: ${{ inputs.head_sha || github.event.pull_request.head.sha }}
      
      # 后续你的构建步骤示例
      - name: Run build
        run: |
          echo "Building PR ${{ inputs.pr_number || github.event.pull_request.number }}"
          # 替换为实际构建命令

关键说明 #

• 权限配置：pull-requests: write是让工作流能更新PR检查状态的必要权限，没有它无法在PR页面展示构建状态。
• 提交关联：通过checkout步骤指定ref为PR的head SHA，GitHub会将该工作流的运行与该提交绑定，从而在PR页面的检查区域显示加载/成功/失败状态。
• 条件过滤：github.event.issue.pull_request确保只有PR的评论才会触发工作流，避免普通issue评论误触发。

修改完成后，开发者在PR下评论/retest时，触发的构建会直接显示在PR页面的检查项中，和Jenkins的效果一致。

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