先读普通工作流日志。如果命令已经运行但错误信息不足,可以开启步骤调试。如果任务卡在初始化阶段,或还没执行第一个步骤就失败,优先看运行器诊断。

把日志和故障位置对应起来

步骤调试会增加任务步骤中的日志详情。运行器诊断会在可下载的归档里加入运行器和工作进程日志。如果命令已经执行,先看对应步骤。如果一直没执行到该命令,就检查 runner-diagnostic-logs 目录中的日志。

控制调试范围

有重跑权限时,可以为一次重跑开启调试。仓库级别也可使用 ACTIONS_STEP_DEBUG 或 ACTIONS_RUNNER_DEBUG。尽量用范围明确的诊断运行,转发下载的日志前检查其中是否包含环境或配置细节。

GitHub 文档:https://docs.github.com/en/actions/how-tos/monitor-workflows/enable-debug-logging