先确认推送使用的凭据
打开产生提交的自动化运行,记下新提交的 SHA。核对 checkout 和 push 的认证方式,包括是否沿用 checkout 保存的凭据,再看下游工作流的事件与筛选条件。完全没有运行要查触发;已有失败运行则查它的日志。
例如夜间任务生成数据文件,并用 GITHUB_TOKEN 推送。校验工作流监听 push,却没有该提交的运行。在授权测试分支用一次无副作用的人工提交作对照。如果人工推送启动 CI,而机器人没有,就找到了可重复解释的差异。
设计明确的后续触发
若生成和验证是同一个操作,可以在原工作流内验证。后续作业依赖生成作业,并确认它验证的是目标提交或传递的产物,同时在日志记录 SHA。
需要独立工作流时,可考虑 workflow_dispatch 或 repository_dispatch,并核对 API 所需权限。经过批准的受限 GitHub App 凭据也是一种选择。改变认证前先设计避免循环的条件,例如只处理尚未生成过结果的提交。
核对实际运行的事件
GitHub 当前文档还说明了一项特殊情况:GITHUB_TOKEN 打开、同步或重新打开拉取请求时,可以生成等待批准的运行。排查自动拉取请求时要看是否处于这个状态。
用小改动验证方案,核对生成方 SHA、消费方事件及实际验证的代码或产物,再故意制造一个无害校验失败,确认错误可见。成功标准是目标修订确实拿到了结果。本文依据 GitHub 文档,夜间任务为演示。