How do I debug a GitHub Actions failure?
Short answer: Find the first failed step in the job, read a few lines above the error, then check whether the workflow command, dependency cache, secret, or environment changed.
Steps
- Paste the failed job log and the relevant workflow YAML.
- Find the first failed command instead of the final summary line.
- Check cache, dependency install, environment variables, permissions, and matrix values.
- Reproduce locally with the same command before changing the pipeline.
Use debugtools
Open the CI / GitHub Actions Debugger to run this workflow in the browser.
Related tools
Build DiffBundle AnalyzerSecret Scanner