使用checks-action时，GitHub Actions无法向PR主页评论内容

1. 确认checks-action的上下文传递是否正确 #

• 使用checks-action时，必须确保它把PR的head_sha或check_run_id正确传递给后续的github-script，很多404错误都是因为脚本用了错误的SHA或ID（比如误拿了工作流自身的SHA而非PR的head SHA）。
• 示例配置：

  - name: 执行checks-action
    uses: LouisBrunner/checks-action@v1.6.0
    id: custom-check
    with:
      token: ${{ secrets.GITHUB_TOKEN }}
      name: 自定义检查任务
      head_sha: ${{ github.event.pull_request.head.sha }}
      status: completed
      conclusion: success
  

  后续github-script里直接调用${{ steps.custom-check.outputs.check_run_id }}关联这个检查任务，不要盲目使用github上下文里的默认ID。

2. 严格校验GITHUB_TOKEN的权限范围 #

• 即便你调整过权限，也要明确：checks-action需要的权限和普通PR评论不同，必须在工作流开头声明足够的权限：

  permissions:
    checks: write
    pull-requests: write
  

• 注意：如果是fork仓库触发的PR工作流，默认GITHUB_TOKEN权限会受限，这时候必须用**个人访问令牌（PAT）**替代，且PAT要勾选repo权限。

3. 修正github-script的API调用路径 #

• 直接调用GitHub API时，要确保路径完全正确。比如更新检查输出的API路径是针对check-run的，而非PR评论路径，示例正确调用：

  const checkRunId = process.env.CHECK_RUN_ID;
  await github.rest.checks.update({
    owner: context.repo.owner,
    repo: context.repo.repo,
    check_run_id: checkRunId,
    output: {
      title: "检查完成",
      summary: "所有检查项通过",
      text: "详细输出内容..."
    }
  });
  

  这里的check_run_id必须来自checks-action的输出，不能硬编码或使用错误的ID。

4. 升级checks-action到最新稳定版 #

• 旧版本的checks-action可能存在上下文传递的bug，建议直接使用最新稳定版（比如v1.6.0及以上），避免因版本兼容问题导致ID传递错误。

5. 快速调试技巧 #

• 在github-script里先打印关键变量，确认值是否正确：

  console.log("仓库信息:", context.repo);
  console.log("检查任务ID:", checkRunId);
  

  这样能快速定位是变量错误还是权限问题。

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