How to invalidate or erase previous GitHub Checks/CI results after a push to main/master?

在持续集成（CI）已成为现代软件开发标配的今天，GitHub Checks功能为团队提供了代码质量检查的直观反馈。然而，许多开发者都遇到过这样一个棘手问题：当向主分支（main/master）推送新代码后，之前的CI检查结果仍然“阴魂不散”，导致合并按钮灰色不可用，甚至引发不必要的回滚确认。近日，开发者社区围绕“如何在推送后作废或清除旧的GitHub Checks/CI结果”展开了热烈讨论。本文将梳理几种主流方案，助你告别“脏数据”困扰。

问题根源：为何旧结果无法自动清除？

GitHub Checks是GitHub Actions、第三方CI工具（如Jenkins、CircleCI）与仓库交互的核心接口。默认情况下，每次推送到分支都会触发新的Check Run，但已完成的Check并不会因新推送而自动标记为“过期”。这尤其出现在两种场景：一是手动修改了CI配置后重新推送，旧结果仍显示“通过”；二是误推代码后立即修正，但新版检查尚未完成，旧结果便成为合并的“绊脚石”。

方案一：利用GitHub API手动作废

最直接的方式是通过GitHub REST API强制更新Check Run状态。步骤如下：

获取Check Run ID：可在GitHub Actions日志页面或通过API GET /repos/{owner}/{repo}/check-runs 获取。
发送PATCH请求：调用 PATCH /repos/{owner}/{repo}/check-runs/{check_run_id}，将 conclusion 设为 cancelled 或 neutral，并将 status 改为 completed。

示例cURL命令：

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  -d '{"status":"completed","conclusion":"cancelled"}'

注意：此操作需拥有仓库的写入权限，且只能作用于当前用户有权访问的Check Run。对于多个CI系统，可能需要遍历所有ID。

方案二：通过分支保护规则“时间戳”绕过

如果只想快速合并代码，而非真正删除结果，可以调整分支保护规则。在仓库Settings -> Branches中，找到目标分支的保护规则，取消勾选 “Require status checks to pass before merging” ，或手动移除与旧CI关联的Check Run名称。但这样做会暂时降低安全性，需事后恢复。

更优雅的做法是：在保护规则中启用 “Require branches to be up to date” 选项。这样，只有当新推送的代码通过所有最新CI检查后，合并按钮才会可用。旧结果自然被新结果覆盖。

方案三：强制推送（Force Push）的“副作用”

部分开发者尝试通过 git push --force 来删除历史提交，从而连带清除CI记录。但强烈不推荐此方法：一是强制推送会重写仓库历史，协作团队可能丢失代码；二是GitHub Checks与提交ID严格绑定，即使历史被改写，旧Check Run仍可能留存于数据库，只是不再关联当前HEAD。

仅当你确定仓库只有自己一人维护，且愿意承受历史丢失风险时，才可考虑此法。操作后需立刻运行新推送，让新提交触发新的Check Run。

方案四：利用GitHub Actions工作流自动化清除

若问题频繁发生，可编写一个自定义GitHub Action，监听 push 事件。当检测到推送到main/master时，自动查找所有未完成的Check Run并取消。示例YAML片段如下：

name: Clear Stale Checks
on:
  push:
    branches: [ main, master ]
jobs:
  cancel-old-checks:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Cancel previous runs
        uses: styfle/cancel-workflow-action@0.12.1
        with:
          access_token: ${{ github.token }}
          workflow_id: all

其中 cancel-workflow-action 是开源第三方的Action，可自动取消同一分支上的重复运行。注意：它仅作用于GitHub Actions自身触发的Check Run，第三方CI需另行处理。

注意事项

权限问题：几乎所有API操作都需要个人访问令牌（PAT），且令牌需具备 repo:status 和 repo:public_repo 范围。
CI耦合性：某些CI系统（如Travis CI）会在Check Run中嵌入独特标识，直接修改可能违反服务条款。建议优先从CI工具端取消任务。
合规审计：频繁删除CI结果可能被解释为规避审查，团队协作时应在项目规范中明确规则。

长远建议：重构工作流

与其事后清理，不如防患于未然。推荐以下最佳实践： - 在CI配置中启用 “Concurrency Groups” （并发组），确保同一分支只保留最新一次运行。 - 使用 on: push: branches-ignore: [main, master] 限制主分支直接推送，改为强制走Pull Request，这样PR检查自然会在代码更新时刷新。 - 定期使用 gh run list 和 gh run cancel 命令（GitHub CLI）批量清理陈旧的Run。

结语

GitHub Checks的“粘性”虽带来一时困扰，但只要理解其工作逻辑，选择合适的清除方案并不难。从API手动操作到智能化工作流，开发者完全可以根据团队规模和安全要求灵活应对。记住：好代码不仅要写得漂亮，更要让CI流程整洁如新。小技巧往往能节省团队大量排查时间。