GitHub Action CI任务步骤失败却显示日志丢失，该如何排查？

• 检查日志大小限制：GitHub单条日志有100MB上限，若步骤输出超限会被截断或删除。可以先查看其他步骤日志是否存在超大输出情况，后续运行时给该步骤添加日志过滤（比如用grep筛选关键内容）或截断逻辑（比如command | head -n 10000）。

• 通过GitHub CLI/API拉取日志：安装GitHub CLI后执行gh run view <RUN_ID> --log直接拉取完整日志；或者调用GitHub REST API的日志接口，有时候网页端显示异常但API能返回完整内容。

• 自托管Runner检查本地日志：如果使用的是自托管Runner，前往Runner机器的_diag目录（Windows：C:\actions-runner\_diag，Linux/macOS：/actions-runner/_diag）查看本地日志，排查是否存在Runner崩溃、网络断连等导致日志未上传的情况。

• 重新触发任务并添加调试手段：手动重跑任务，给失败步骤增加调试逻辑：

  • 插入echo命令记录关键节点的运行状态
  • Linux/macOS环境用set -x、Windows环境用Set-PSDebug -Trace 1开启命令追踪模式，输出每一条执行的命令
  • 针对长时间运行的操作，添加定期心跳日志（比如每5分钟输出一次当前进度），避免因长时间无输出被判定为任务中断

• 确认GitHub服务状态：查看GitHub官方状态页面，排查任务运行时段是否存在Actions服务故障，若有服务异常，等待恢复后再尝试查看日志。

• 检查超时配置：查看Workflow文件中该步骤是否设置了timeout-minutes参数，若设置值小于45分钟，会导致步骤被强制终止并可能伴随日志丢失；使用自托管Runner的话，还要检查Runner的全局超时配置。

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