GitHub Actions 故障排除技能

使用 gh CLI 和 Git 诊断并修复 GitHub Actions 工作流失败问题，特别适用于 Go 项目。本技能帮助判断失败是代码问题还是环境/配置问题所致。

工作流分析

查看最近工作流运行的状态：

gh run list --repo owner/repo --limit 10

查看特定失败工作流的详细信息：

gh run view <run-id> --repo owner/repo

仅获取失败任务的日志：

gh run view <run-id> --repo owner/repo --log-failed

识别问题类型

1. 代码问题：在编译、测试或代码检查阶段出现的失败，在不同环境中均一致发生
2. 环境问题：CI 中依赖解析、工具安装或类型检查失败，但在本地可正常运行

常见 Go CI 修复方法

代码检查器配置问题

• 注意“未定义”引用错误，这可能表明导入解析存在问题
• 尝试使用最小化的代码检查器配置，禁用类型检查类检查器
• 使用 golangci-lint run --disable-all --enable=gofmt 进行基础语法检查

依赖项解析问题

• 确认 go.mod 和 go.sum 文件内容一致
• 执行 go mod tidy 以解决依赖冲突
• 检查所需依赖是否已正确声明

诊断命令

查看特定工作流任务的日志：

gh run view --job <job-id> --repo owner/repo

下载工作流生成的构建产物以便检查：

gh run download <run-id> --repo owner/repo

故障排除流程

1. 确定哪些任务失败，哪些任务成功
2. 分析错误信息，判断问题性质
3. 判断问题是否可在本地复现
4. 根据问题类型应用针对性修复措施
5. 监控后续工作流运行情况，确认问题已解决